@josuelmm/capacitor-background-geolocation 1.0.0

package/ios/common/BackgroundGeolocation/INTULocationManager/INTULocationRequest.h

@@ -0,0 +1,103 @@
+//
+//  INTULocationRequest.h
+//
+//  Copyright (c) 2014-2017 Intuit Inc.
+//
+//  Permission is hereby granted, free of charge, to any person obtaining
+//  a copy of this software and associated documentation files (the
+//  "Software"), to deal in the Software without restriction, including
+//  without limitation the rights to use, copy, modify, merge, publish,
+//  distribute, sublicense, and/or sell copies of the Software, and to
+//  permit persons to whom the Software is furnished to do so, subject to
+//  the following conditions:
+//
+//  The above copyright notice and this permission notice shall be
+//  included in all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+//  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+//  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+//  NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+//  LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+//  OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+//  WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+//
+
+#import "INTULocationRequestDefines.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+/** The available types of location requests. */
+typedef NS_ENUM(NSInteger, INTULocationRequestType) {
+    /** A one-time location request with a specific desired accuracy and optional timeout. */
+    INTULocationRequestTypeSingle,
+    /** A subscription to location updates. */
+    INTULocationRequestTypeSubscription,
+    /** A subscription to significant location changes. */
+    INTULocationRequestTypeSignificantChanges
+};
+
+@class INTULocationRequest;
+
+/**
+ Protocol for the INTULocationRequest to notify the its delegate that a request has timed out.
+ */
+@protocol INTULocationRequestDelegate
+
+/**
+ Notification that a location request has timed out.
+ 
+ @param locationRequest The location request that timed out.
+ */
+- (void)locationRequestDidTimeout:(INTULocationRequest *)locationRequest;
+
+@end
+
+
+/**
+ Represents a geolocation request that is created and managed by INTULocationManager.
+ */
+@interface INTULocationRequest : NSObject
+
+/** The delegate for this location request. */
+@property (nonatomic, weak, nullable) id<INTULocationRequestDelegate> delegate;
+/** The request ID for this location request (set during initialization). */
+@property (nonatomic, readonly) INTULocationRequestID requestID;
+/** The type of this location request (set during initialization). */
+@property (nonatomic, readonly) INTULocationRequestType type;
+/** Whether this is a recurring location request (type is either Subscription or SignificantChanges). */
+@property (nonatomic, readonly) BOOL isRecurring;
+/** The desired accuracy for this location request. */
+@property (nonatomic, assign) INTULocationAccuracy desiredAccuracy;
+/** The maximum amount of time the location request should be allowed to live before completing.
+    If this value is exactly 0.0, it will be ignored (the request will never timeout by itself). */
+@property (nonatomic, assign) NSTimeInterval timeout;
+/** How long the location request has been alive since the timeout value was last set. */
+@property (nonatomic, readonly) NSTimeInterval timeAlive;
+/** Whether this location request has timed out (will also be YES if it has been completed). Subcriptions can never time out. */
+@property (nonatomic, readonly) BOOL hasTimedOut;
+/** The block to execute when the location request completes. */
+@property (nonatomic, copy, nullable) INTULocationRequestBlock block;
+
+/** Designated initializer. Initializes and returns a newly allocated location request object with the specified type. */
+- (instancetype)initWithType:(INTULocationRequestType)type __INTU_DESIGNATED_INITIALIZER;
+
+/** Completes the location request. */
+- (void)complete;
+/** Forces the location request to consider itself timed out. */
+- (void)forceTimeout;
+/** Cancels the location request. */
+- (void)cancel;
+
+/** Starts the location request's timeout timer if a nonzero timeout value is set, and the timer has not already been started. */
+- (void)startTimeoutTimerIfNeeded;
+
+/** Returns the associated recency threshold (in seconds) for the location request's desired accuracy level. */
+- (NSTimeInterval)updateTimeStaleThreshold;
+
+/** Returns the associated horizontal accuracy threshold (in meters) for the location request's desired accuracy level. */
+- (CLLocationAccuracy)horizontalAccuracyThreshold;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/common/BackgroundGeolocation/INTULocationManager/INTULocationRequest.m

@@ -0,0 +1,238 @@
+//
+//  INTULocationRequest.m
+//
+//  Copyright (c) 2014-2017 Intuit Inc.
+//
+//  Permission is hereby granted, free of charge, to any person obtaining
+//  a copy of this software and associated documentation files (the
+//  "Software"), to deal in the Software without restriction, including
+//  without limitation the rights to use, copy, modify, merge, publish,
+//  distribute, sublicense, and/or sell copies of the Software, and to
+//  permit persons to whom the Software is furnished to do so, subject to
+//  the following conditions:
+//
+//  The above copyright notice and this permission notice shall be
+//  included in all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+//  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+//  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+//  NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+//  LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+//  OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+//  WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+//
+
+#import "INTULocationRequest.h"
+#import "INTURequestIDGenerator.h"
+
+@interface INTULocationRequest ()
+
+// Redeclare this property as readwrite for internal use.
+@property (nonatomic, assign, readwrite) BOOL hasTimedOut;
+
+/** The NSDate representing the time when the request started. Set when the |timeout| property is set. */
+@property (nonatomic, strong) NSDate *requestStartTime;
+/** The timer that will fire to notify this request that it has timed out. Started when the |timeout| property is set. */
+@property (nonatomic, strong) NSTimer *timeoutTimer;
+
+@end
+
+
+@implementation INTULocationRequest
+
+/**
+ Throws an exeption when you try to create a location request using a non-designated initializer.
+ */
+- (instancetype)init
+{
+    @throw [NSException exceptionWithName:NSInternalInconsistencyException reason:@"Must use initWithType: instead." userInfo:nil];
+    return [self initWithType:INTULocationRequestTypeSingle];
+}
+
+/**
+ Designated initializer. Initializes and returns a newly allocated location request object with the specified type.
+ 
+ @param type The type of the location request. 
+ */
+- (instancetype)initWithType:(INTULocationRequestType)type
+{
+    self = [super init];
+    if (self) {
+        _requestID = [INTURequestIDGenerator getUniqueRequestID];
+        _type = type;
+        _hasTimedOut = NO;
+    }
+    return self;
+}
+
+/**
+ Returns the associated recency threshold (in seconds) for the location request's desired accuracy level.
+ */
+- (NSTimeInterval)updateTimeStaleThreshold
+{
+    switch (self.desiredAccuracy) {
+        case INTULocationAccuracyRoom:
+            return kINTUUpdateTimeStaleThresholdRoom;
+            break;
+        case INTULocationAccuracyHouse:
+            return kINTUUpdateTimeStaleThresholdHouse;
+            break;
+        case INTULocationAccuracyBlock:
+            return kINTUUpdateTimeStaleThresholdBlock;
+            break;
+        case INTULocationAccuracyNeighborhood:
+            return kINTUUpdateTimeStaleThresholdNeighborhood;
+            break;
+        case INTULocationAccuracyCity:
+            return kINTUUpdateTimeStaleThresholdCity;
+            break;
+        default:
+            NSAssert(NO, @"Unknown desired accuracy.");
+            return 0.0;
+            break;
+    }
+}
+
+/**
+ Returns the associated horizontal accuracy threshold (in meters) for the location request's desired accuracy level.
+ */
+- (CLLocationAccuracy)horizontalAccuracyThreshold
+{
+    switch (self.desiredAccuracy) {
+        case INTULocationAccuracyRoom:
+            return kINTUHorizontalAccuracyThresholdRoom;
+            break;
+        case INTULocationAccuracyHouse:
+            return kINTUHorizontalAccuracyThresholdHouse;
+            break;
+        case INTULocationAccuracyBlock:
+            return kINTUHorizontalAccuracyThresholdBlock;
+            break;
+        case INTULocationAccuracyNeighborhood:
+            return kINTUHorizontalAccuracyThresholdNeighborhood;
+            break;
+        case INTULocationAccuracyCity:
+            return kINTUHorizontalAccuracyThresholdCity;
+            break;
+        default:
+            NSAssert(NO, @"Unknown desired accuracy.");
+            return 0.0;
+            break;
+    }
+}
+
+/**
+ Completes the location request.
+ */
+- (void)complete
+{
+    [self.timeoutTimer invalidate];
+    self.timeoutTimer = nil;
+    self.requestStartTime = nil;
+}
+
+/**
+ Forces the location request to consider itself timed out.
+ */
+- (void)forceTimeout
+{
+    if (self.isRecurring == NO) {
+        self.hasTimedOut = YES;
+    } else {
+        NSAssert(self.isRecurring == NO, @"Only single location requests (not recurring requests) should ever be considered timed out.");
+    }
+}
+
+/**
+ Cancels the location request.
+ */
+- (void)cancel
+{
+    [self.timeoutTimer invalidate];
+    self.timeoutTimer = nil;
+    self.requestStartTime = nil;
+}
+
+/**
+ Starts the location request's timeout timer if a nonzero timeout value is set, and the timer has not already been started.
+ */
+- (void)startTimeoutTimerIfNeeded
+{
+    if (self.timeout > 0 && !self.timeoutTimer) {
+        self.requestStartTime = [NSDate date];
+        self.timeoutTimer = [NSTimer scheduledTimerWithTimeInterval:self.timeout target:self selector:@selector(timeoutTimerFired:) userInfo:nil repeats:NO];
+    }
+}
+
+/**
+ Computed property that returns whether this is a subscription request.
+ */
+- (BOOL)isRecurring
+{
+    return (self.type == INTULocationRequestTypeSubscription) || (self.type == INTULocationRequestTypeSignificantChanges);
+}
+
+/**
+ Computed property that returns how long the request has been alive (since the timeout value was set).
+ */
+- (NSTimeInterval)timeAlive
+{
+    if (self.requestStartTime == nil) {
+        return 0.0;
+    }
+    return fabs([self.requestStartTime timeIntervalSinceNow]);
+}
+
+/**
+ Returns whether the location request has timed out or not.
+ Once this becomes YES, it will not automatically reset to NO even if a new timeout value is set.
+ */
+- (BOOL)hasTimedOut
+{
+    if (self.timeout > 0.0 && self.timeAlive > self.timeout) {
+        _hasTimedOut = YES;
+    }
+    return _hasTimedOut;
+}
+
+/**
+ Callback when the timeout timer fires. Notifies the delegate that this event has occurred.
+ */
+- (void)timeoutTimerFired:(NSTimer *)timer
+{
+    self.hasTimedOut = YES;
+    [self.delegate locationRequestDidTimeout:self];
+}
+
+/**
+ Two location requests are considered equal if their request IDs match.
+ */
+- (BOOL)isEqual:(id)object
+{
+    if (object == self) {
+        return YES;
+    }
+    if (!object || ![object isKindOfClass:[self class]]) {
+        return NO;
+    }
+    if (((INTULocationRequest *)object).requestID == self.requestID) {
+        return YES;
+    }
+    return NO;
+}
+
+/**
+ Return a hash based on the string representation of the request ID.
+ */
+- (NSUInteger)hash
+{
+    return [[NSString stringWithFormat:@"%ld", (long)self.requestID] hash];
+}
+
+- (void)dealloc
+{
+    [_timeoutTimer invalidate];
+}
+
+@end

package/ios/common/BackgroundGeolocation/INTULocationManager/INTULocationRequestDefines.h

@@ -0,0 +1,163 @@
+//
+//  INTULocationRequestDefines.h
+//
+//  Copyright (c) 2014-2017 Intuit Inc.
+//
+//  Permission is hereby granted, free of charge, to any person obtaining
+//  a copy of this software and associated documentation files (the
+//  "Software"), to deal in the Software without restriction, including
+//  without limitation the rights to use, copy, modify, merge, publish,
+//  distribute, sublicense, and/or sell copies of the Software, and to
+//  permit persons to whom the Software is furnished to do so, subject to
+//  the following conditions:
+//
+//  The above copyright notice and this permission notice shall be
+//  included in all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+//  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+//  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+//  NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+//  LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+//  OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+//  WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+//
+
+#ifndef INTU_LOCATION_REQUEST_DEFINES_H
+#define INTU_LOCATION_REQUEST_DEFINES_H
+
+#import <Foundation/Foundation.h>
+#import <CoreLocation/CoreLocation.h>
+
+#if __has_feature(objc_generics)
+#   define __INTU_GENERICS(type, ...)       type<__VA_ARGS__>
+#else
+#   define __INTU_GENERICS(type, ...)       type
+#endif
+
+#ifdef NS_DESIGNATED_INITIALIZER
+#   define __INTU_DESIGNATED_INITIALIZER    NS_DESIGNATED_INITIALIZER
+#else
+#   define __INTU_DESIGNATED_INITIALIZER
+#endif
+
+static const CLLocationAccuracy kINTUHorizontalAccuracyThresholdCity =         5000.0;  // in meters
+static const CLLocationAccuracy kINTUHorizontalAccuracyThresholdNeighborhood = 1000.0;  // in meters
+static const CLLocationAccuracy kINTUHorizontalAccuracyThresholdBlock =         100.0;  // in meters
+static const CLLocationAccuracy kINTUHorizontalAccuracyThresholdHouse =          15.0;  // in meters
+static const CLLocationAccuracy kINTUHorizontalAccuracyThresholdRoom =            5.0;  // in meters
+
+static const NSTimeInterval kINTUUpdateTimeStaleThresholdCity =             600.0;  // in seconds
+static const NSTimeInterval kINTUUpdateTimeStaleThresholdNeighborhood =     300.0;  // in seconds
+static const NSTimeInterval kINTUUpdateTimeStaleThresholdBlock =             60.0;  // in seconds
+static const NSTimeInterval kINTUUpdateTimeStaleThresholdHouse =             15.0;  // in seconds
+static const NSTimeInterval kINTUUpdateTimeStaleThresholdRoom =               5.0;  // in seconds
+
+/** The possible states that location services can be in. */
+typedef NS_ENUM(NSInteger, INTULocationServicesState) {
+    /** User has already granted this app permissions to access location services, and they are enabled and ready for use by this app.
+        Note: this state will be returned for both the "When In Use" and "Always" permission levels. */
+    INTULocationServicesStateAvailable,
+    /** User has not yet responded to the dialog that grants this app permission to access location services. */
+    INTULocationServicesStateNotDetermined,
+    /** User has explicitly denied this app permission to access location services. (The user can enable permissions again for this app from the system Settings app.) */
+    INTULocationServicesStateDenied,
+    /** User does not have ability to enable location services (e.g. parental controls, corporate policy, etc). */
+    INTULocationServicesStateRestricted,
+    /** User has turned off location services device-wide (for all apps) from the system Settings app. */
+    INTULocationServicesStateDisabled
+};
+
+/** The possible states that heading services can be in. */
+typedef NS_ENUM(NSInteger, INTUHeadingServicesState) {
+    /** Heading services are available on the device */
+    INTUHeadingServicesStateAvailable,
+    /** Heading services are available on the device */
+    INTUHeadingServicesStateUnavailable,
+};
+
+/** A unique ID that corresponds to one location request. */
+typedef NSInteger INTULocationRequestID;
+
+/** A unique ID that corresponds to one heading request. */
+typedef NSInteger INTUHeadingRequestID;
+
+/** An abstraction of both the horizontal accuracy and recency of location data.
+    Room is the highest level of accuracy/recency; City is the lowest level. */
+typedef NS_ENUM(NSInteger, INTULocationAccuracy) {
+    // 'None' is not valid as a desired accuracy.
+    /** Inaccurate (>5000 meters, and/or received >10 minutes ago). */
+    INTULocationAccuracyNone = 0,
+    
+    // The below options are valid desired accuracies.
+    /** 5000 meters or better, and received within the last 10 minutes. Lowest accuracy. */
+    INTULocationAccuracyCity,
+    /** 1000 meters or better, and received within the last 5 minutes. */
+    INTULocationAccuracyNeighborhood,
+    /** 100 meters or better, and received within the last 1 minute. */
+    INTULocationAccuracyBlock,
+    /** 15 meters or better, and received within the last 15 seconds. */
+    INTULocationAccuracyHouse,
+    /** 5 meters or better, and received within the last 5 seconds. Highest accuracy. */
+    INTULocationAccuracyRoom,
+};
+
+/** An alias of the heading filter accuracy in degrees.
+    Specifies the minimum amount of change in degrees needed for a heading service update. Observers will not be notified of updates less than the stated filter value. */
+typedef CLLocationDegrees INTUHeadingFilterAccuracy;
+
+/** A status that will be passed in to the completion block of a location request. */
+typedef NS_ENUM(NSInteger, INTULocationStatus) {
+    // These statuses will accompany a valid location.
+    /** Got a location and desired accuracy level was achieved successfully. */
+    INTULocationStatusSuccess = 0,
+    /** Got a location, but the desired accuracy level was not reached before timeout. (Not applicable to subscriptions.) */
+    INTULocationStatusTimedOut,
+    
+    // These statuses indicate some sort of error, and will accompany a nil location.
+    /** User has not yet responded to the dialog that grants this app permission to access location services. */
+    INTULocationStatusServicesNotDetermined,
+    /** User has explicitly denied this app permission to access location services. */
+    INTULocationStatusServicesDenied,
+    /** User does not have ability to enable location services (e.g. parental controls, corporate policy, etc). */
+    INTULocationStatusServicesRestricted,
+    /** User has turned off location services device-wide (for all apps) from the system Settings app. */
+    INTULocationStatusServicesDisabled,
+    /** An error occurred while using the system location services. */
+    INTULocationStatusError
+};
+
+/** A status that will be passed in to the completion block of a heading request. */
+typedef NS_ENUM(NSInteger, INTUHeadingStatus) {
+    // These statuses will accompany a valid heading.
+    /** Got a heading successfully. */
+    INTUHeadingStatusSuccess = 0,
+
+    // These statuses indicate some sort of error, and will accompany a nil heading.
+    /** Heading was invalid. */
+    INTUHeadingStatusInvalid,
+
+    /** Heading services are not available on the device */
+    INTUHeadingStatusUnavailable
+};
+
+/**
+ A block type for a location request, which is executed when the request succeeds, fails, or times out.
+ 
+ @param currentLocation The most recent & accurate current location available when the block executes, or nil if no valid location is available.
+ @param achievedAccuracy The accuracy level that was actually achieved (may be better than, equal to, or worse than the desired accuracy).
+ @param status The status of the location request - whether it succeeded, timed out, or failed due to some sort of error. This can be used to
+               understand what the outcome of the request was, decide if/how to use the associated currentLocation, and determine whether other
+               actions are required (such as displaying an error message to the user, retrying with another request, quietly proceeding, etc).
+ */
+typedef void(^INTULocationRequestBlock)(CLLocation *currentLocation, INTULocationAccuracy achievedAccuracy, INTULocationStatus status);
+
+/**
+ A block type for a heading request, which is executed when the request succeeds.
+
+ @param currentHeading  The most recent current heading available when the block executes.
+ @param status          The status of the request - whether it succeeded or failed due to some sort of error. This can be used to understand if any further action is needed.
+ */
+typedef void(^INTUHeadingRequestBlock)(CLHeading *currentHeading, INTUHeadingStatus status);
+
+#endif /* INTU_LOCATION_REQUEST_DEFINES_H */

package/ios/common/BackgroundGeolocation/INTULocationManager/INTURequestIDGenerator.h

@@ -0,0 +1,39 @@
+//
+//  INTURequestIDGenerator.h
+//
+//  Copyright (c) 2014-2017 Intuit Inc.
+//
+//  Permission is hereby granted, free of charge, to any person obtaining
+//  a copy of this software and associated documentation files (the
+//  "Software"), to deal in the Software without restriction, including
+//  without limitation the rights to use, copy, modify, merge, publish,
+//  distribute, sublicense, and/or sell copies of the Software, and to
+//  permit persons to whom the Software is furnished to do so, subject to
+//  the following conditions:
+//
+//  The above copyright notice and this permission notice shall be
+//  included in all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+//  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+//  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+//  NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+//  LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+//  OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+//  WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+//
+
+#import "INTULocationRequestDefines.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface INTURequestIDGenerator : NSObject
+
+/**
+ Returns a unique request ID (within the lifetime of the application).
+ */
++(INTULocationRequestID)getUniqueRequestID;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/common/BackgroundGeolocation/INTULocationManager/INTURequestIDGenerator.m

@@ -0,0 +1,37 @@
+//
+//  INTURequestIDGenerator.m
+//
+//  Copyright (c) 2014-2017 Intuit Inc.
+//
+//  Permission is hereby granted, free of charge, to any person obtaining
+//  a copy of this software and associated documentation files (the
+//  "Software"), to deal in the Software without restriction, including
+//  without limitation the rights to use, copy, modify, merge, publish,
+//  distribute, sublicense, and/or sell copies of the Software, and to
+//  permit persons to whom the Software is furnished to do so, subject to
+//  the following conditions:
+//
+//  The above copyright notice and this permission notice shall be
+//  included in all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+//  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+//  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+//  NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+//  LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+//  OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+//  WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+//
+#import "INTURequestIDGenerator.h"
+
+@implementation INTURequestIDGenerator
+
+static INTULocationRequestID _nextRequestID = 0;
+
++(INTULocationRequestID)getUniqueRequestID
+{
+    _nextRequestID++;
+    return _nextRequestID;
+}
+
+@end

package/ios/common/BackgroundGeolocation/MAURAbstractLocationProvider.h

@@ -0,0 +1,51 @@
+//
+//  MAURAbstractLocationProvider.h
+//  BackgroundGeolocation
+//
+//  Created by Marian Hello on 14/09/2016.
+//  Copyright © 2016 mauron85. All rights reserved.
+//
+
+#ifndef MAURAbstractLocationProvider_h
+#define MAURAbstractLocationProvider_h
+
+#import <UIKit/UIKit.h>
+#import <AudioToolbox/AudioToolbox.h>
+#import "MAURBackgroundGeolocationFacade.h"
+#import "MAURProviderDelegate.h"
+#import "MAURConfig.h"
+
+// Debug sounds for bg-geolocation life-cycle events.
+// http://iphonedevwiki.net/index.php/AudioServices
+#define exitRegionSound         1005
+#define locationSyncSound       1004
+#define paceChangeYesSound      1110
+#define paceChangeNoSound       1112
+#define acquiringLocationSound  1103
+#define acquiredLocationSound   1052
+#define locationErrorSound      1073
+
+@protocol MAURLocationProvider <NSObject>
+
+- (void) onCreate;
+- (void) onDestroy;
+- (void) onTerminate;
+- (BOOL) onConfigure:(MAURConfig*)config error:(NSError * __autoreleasing *)outError;
+- (BOOL) onStart:(NSError * __autoreleasing *)outError;
+- (BOOL) onStop:(NSError * __autoreleasing *)outError;
+- (void) onSwitchMode:(MAUROperationalMode)mode;
+
+@end
+
+@interface MAURAbstractLocationProvider : NSObject//<LocationProvider>
+
+@property (weak, nonatomic) id<MAURProviderDelegate> delegate;
+
+- (void) onTerminate;
+- (void) onSwitchMode:(MAUROperationalMode)mode;
+- (void) notify:(NSString*)message;
+
+@end
+
+
+#endif /* MAURAbstractLocationProvider_h */

package/ios/common/BackgroundGeolocation/MAURAbstractLocationProvider.m

@@ -0,0 +1,53 @@
+//
+//  MAURAbstractLocationProvider.m
+//  BackgroundGeolocation
+//
+//  Created by Marian Hello on 14/09/2016.
+//  Copyright © 2016 mauron85. All rights reserved.
+//
+
+#import "MAURAbstractLocationProvider.h"
+
+@implementation MAURAbstractLocationProvider {
+    UILocalNotification *localNotification;
+}
+
+@synthesize delegate;
+
+- (instancetype) init
+{
+    if( [self class] == [MAURAbstractLocationProvider class])
+    {
+        NSAssert(false, @"You cannot init this class directly. Instead, use a subclass e.g. DistanceFilterLocationProvider.h");
+        return nil;
+    }
+    
+    self = [super init];
+    if (self == nil) {
+        return self;
+    }
+    
+    localNotification = [[UILocalNotification alloc] init];
+    localNotification.timeZone = [NSTimeZone defaultTimeZone];
+    
+    return self;
+}
+
+- (void) notify:(NSString*)message
+{
+    localNotification.fireDate = [NSDate date];
+    localNotification.alertBody = message;
+    [[UIApplication sharedApplication] scheduleLocalNotification:localNotification];
+}
+
+- (void) onTerminate
+{
+    // override in sub class
+}
+
+- (void) onSwitchMode:(MAUROperationalMode)mode
+{
+    // override in sub class
+}
+
+@end