@josuelmm/capacitor-background-geolocation 1.0.0

package/ios/common/BackgroundGeolocation/MAURGeolocationOpenHelper.m

@@ -0,0 +1,124 @@
+//
+//  MAURGeolocationOpenHelper.m
+//  BackgroundGeolocation
+//
+//  Created by Marian Hello on 27/06/16.
+//  Copyright © 2016 mauron85. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "MAURGeolocationOpenHelper.h"
+#import "MAURLocationContract.h"
+#import "MAURConfigurationContract.h"
+#import "MAURSessionLocationContract.h"
+
+@implementation MAURGeolocationOpenHelper
+
+static NSString *const kDatabaseName = @"cordova_bg_geolocation.db";
+// v4.5.0: bumped to 7 to add events_json + battery_level + is_charging on locations,
+// and config_json on configuration (paridad con Android v22).
+static NSInteger const kDatabaseVersion = 7;
+
+- (instancetype)init
+{
+    self = [super init:kDatabaseName version:kDatabaseVersion];
+    return self;
+}
+
+- (void) drop:(NSString*)table inDatabase:(FMDatabase*)database
+{
+    NSString *sql = [NSString stringWithFormat: @"DROP TABLE IF EXISTS %@", table];
+    if (![database executeStatements:sql]) {
+        NSLog(@"%@ failed code: %d: message: %@", sql, [database lastErrorCode], [database lastErrorMessage]);
+    }
+}
+
+- (void) onCreate:(FMDatabaseQueue*)queue
+{
+    [queue inDatabase:^(FMDatabase *database) {
+        // because of some legacy code we have to drop table
+        [self drop:@LC_TABLE_NAME inDatabase:database];
+        
+        NSString *sql = [@[
+                           [MAURLocationContract createTableSQL],
+                           [MAURConfigurationContract createTableSQL],
+                           @"CREATE INDEX recorded_at_idx ON " @LC_TABLE_NAME @" (" @LC_COLUMN_NAME_RECORDED_AT @")",
+                           [MAURSessionLocationContract createTableSQL],
+                           @"CREATE INDEX session_recorded_at_idx ON " @LSC_TABLE_NAME @" (" @LSC_COLUMN_NAME_RECORDED_AT @")"
+                           ]  componentsJoinedByString:@";"];
+        if (![database executeStatements:sql]) {
+            NSLog(@"%@ failed code: %d: message: %@", sql, [database lastErrorCode], [database lastErrorMessage]);
+        }
+    }];
+}
+
+- (void) onDowngrade:(FMDatabaseQueue*)queue fromVersion:(NSInteger)oldVersion toVersion:(NSInteger)newVersion
+{
+    NSLog(@"Downgrading geolocation db oldVersion: %ld, newVersion: %ld", oldVersion, newVersion);
+
+    NSString *sql = [@[
+         @"DROP TABLE IF EXISTS " @LC_TABLE_NAME,
+         @"DROP TABLE IF EXISTS " @LSC_TABLE_NAME
+    ] componentsJoinedByString:@";"];
+
+    [queue inDatabase:^(FMDatabase *database) {
+        if (![database executeStatements:sql]) {
+            NSLog(@"Db downgrade failed code: %d: message: %@", [database lastErrorCode], [database lastErrorMessage]);
+        } else {
+            [self onCreate:queue];
+        }
+    }];
+}
+
+- (void) onUpgrade:(FMDatabaseQueue*)queue fromVersion:(NSInteger)oldVersion toVersion:(NSInteger)newVersion
+{
+    NSLog(@"Upgrading geolocation db oldVersion: %ld, newVersion: %ld", oldVersion, newVersion);
+    NSMutableArray *sql = [[NSMutableArray alloc] init];
+    
+    switch (oldVersion) {
+        case 1:
+            [sql addObjectsFromArray: @[
+                @"ALTER TABLE " @LC_TABLE_NAME @" ADD COLUMN " @LC_COLUMN_NAME_RECORDED_AT @" INTEGER",
+                @"UPDATE " @LC_TABLE_NAME @" SET " @LC_COLUMN_NAME_RECORDED_AT @" =" @LC_COLUMN_NAME_TIME,
+                @"CREATE INDEX recorded_at_idx ON " @LC_TABLE_NAME @" (" @LC_COLUMN_NAME_RECORDED_AT @")",
+                @"DROP INDEX IF EXISTS time_idx"
+            ]];
+        case 2:
+            [sql addObjectsFromArray: @[
+                [MAURConfigurationContract createTableSQL]
+            ]];
+        case 3:
+            [sql addObjectsFromArray: @[
+                [NSString stringWithFormat:@"ALTER TABLE %s ADD COLUMN %s INTEGER", CC_TABLE_NAME, CC_COLUMN_NAME_SYNC_ENABLED]
+            ]];
+        case 4:
+            [sql addObjectsFromArray: @[
+                [MAURSessionLocationContract createTableSQL],
+                [NSString stringWithFormat:@"CREATE INDEX session_recorded_at_idx ON %@ (%@)", @LSC_TABLE_NAME, @LSC_COLUMN_NAME_RECORDED_AT]
+            ]];
+        case 5:
+            // v4.5.0: persist driving events / battery / charging on locations.
+            [sql addObjectsFromArray: @[
+                @"ALTER TABLE " @LC_TABLE_NAME @" ADD COLUMN " @LC_COLUMN_NAME_EVENTS_JSON @" TEXT",
+                @"ALTER TABLE " @LC_TABLE_NAME @" ADD COLUMN " @LC_COLUMN_NAME_BATTERY_LEVEL @" INTEGER",
+                @"ALTER TABLE " @LC_TABLE_NAME @" ADD COLUMN " @LC_COLUMN_NAME_IS_CHARGING @" INTEGER"
+            ]];
+        case 6:
+            // v4.5.0: full config persisted as JSON blob (paridad con Android config_json).
+            [sql addObjectsFromArray: @[
+                [NSString stringWithFormat:@"ALTER TABLE %s ADD COLUMN %s TEXT", CC_TABLE_NAME, CC_COLUMN_NAME_CONFIG_JSON]
+            ]];
+            break; // break only for previous db version (cascade statements)
+        default:
+            return;
+    }
+
+    [queue inDatabase:^(FMDatabase *database) {
+        NSString *stmt = [sql componentsJoinedByString:@";"];
+        if (![database executeStatements:stmt]) {
+            NSLog(@"Db upgrade failed code: %d: message: %@", [database lastErrorCode], [database lastErrorMessage]);
+        }
+    }];
+}
+
+@end

package/ios/common/BackgroundGeolocation/MAURLocation.h

@@ -0,0 +1,73 @@
+//
+//  MAURLocation.h
+//  BackgroundGeolocation
+//
+//  Created by Marian Hello on 10/06/16.
+//
+
+#ifndef MAURLocation_h
+#define MAURLocation_h
+
+#import <Foundation/Foundation.h>
+#import <CoreLocation/CoreLocation.h>
+
+@class MAURLocation;
+
+typedef MAURLocation * _Nullable (^ MAURLocationTransform)(MAURLocation * _Nonnull location);
+
+typedef NS_ENUM(NSInteger, MAURLocationStatus) {
+    MAURLocationDeleted = 0,
+    MAURLocationPostPending = 1,
+    MAURLocationSyncPending = 2,
+};
+
+@interface MAURLocation : NSObject <NSCopying>
+
+@property (nonatomic, retain) NSNumber *locationId;
+@property (nonatomic, retain) NSDate *time;
+@property (nonatomic, retain) NSNumber *accuracy;
+@property (nonatomic, retain) NSNumber *altitudeAccuracy;
+@property (nonatomic, retain) NSNumber *speed;
+@property (nonatomic, retain) NSNumber *heading;
+@property (nonatomic, retain) NSNumber *altitude;
+@property (nonatomic, retain) NSNumber *latitude;
+@property (nonatomic, retain) NSNumber *longitude;
+@property (nonatomic, retain) NSString *provider;
+@property (nonatomic, retain) NSNumber *locationProvider;
+@property (nonatomic, retain) NSNumber *radius; //only for stationary locations
+@property (nonatomic) BOOL isValid;
+@property (nonatomic, retain) NSDate *recordedAt;
+/** True if location was simulated by software (e.g. Simulator). iOS 15+. */
+@property (nonatomic, retain) NSNumber *simulated;
+/**
+ * v4.3 — Driving events anexados a este fix.
+ * v4.5: persiste en SQLite (events_json TEXT) — sobrevive a la cola de sync.
+ * Cada elemento es un NSDictionary con al menos { "type": NSString, "time": NSNumber }.
+ */
+@property (nonatomic, retain) NSMutableArray *drivingEvents;
+/** v4.4 — Battery percentage (0-100) at the time of this fix.
+ *  v4.5: persisted in SQLite (battery_level INTEGER). */
+@property (nonatomic, retain) NSNumber *batteryLevel;
+/** v4.4 — Whether the device is charging at the time of this fix.
+ *  v4.5: persisted in SQLite (is_charging INTEGER). */
+@property (nonatomic, retain) NSNumber *isCharging;
+
++ (instancetype) fromCLLocation:(CLLocation*)location;
++ (NSTimeInterval) locationAge:(CLLocation*)location;
++ (NSMutableDictionary*) toDictionary:(CLLocation*)location;
+- (NSTimeInterval) locationAge;
+- (NSDictionary*) toDictionary;
+- (NSDictionary*) toDictionaryWithId;
+- (id) toResultFromTemplate:(id)locationTemplate;
+- (CLLocationCoordinate2D) coordinate;
+- (BOOL) hasAccuracy;
+- (BOOL) hasTime;
+- (double) distanceFromLocation:(MAURLocation*)location;
+- (BOOL) isBetterLocation:(MAURLocation*)location;
+- (BOOL) isBeyond:(MAURLocation*)location radius:(NSInteger)radius;
+- (id) copyWithZone: (NSZone *)zone;
+- (id) getValueForKey:(id)key;
+
+@end
+
+#endif /* MAURLocation_h */

package/ios/common/BackgroundGeolocation/MAURLocation.m

@@ -0,0 +1,392 @@
+//
+//  MAURLocation.m
+//  BackgroundGeolocation
+//
+//  Created by Marian Hello on 10/06/16.
+//
+
+#import <Foundation/Foundation.h>
+#import <CoreLocation/CoreLocation.h>
+#import "MAURLocation.h"
+
+enum {
+    TWO_MINUTES = 120,
+    MAX_SECONDS_FROM_NOW = 86400
+};
+
+@interface MAURLocationMapper : NSObject
+- (NSDictionary*) withDictionary:(NSDictionary*)values;
+- (NSArray*) withArray:(NSArray*)values;
++ (instancetype) map:(MAURLocation*)location;
+@end
+
+// v4.5.1 — _location was previously a file-scope global. With real-time post (background queue)
+// and background sync (NSURLSession queue) running concurrently, the second [+map:] invocation
+// overwrote _location while the first mapper was mid-serialize, producing mixed location fields
+// at the backend. Now per-instance ivar.
+@implementation MAURLocationMapper {
+    MAURLocation *_location;
+}
+
+- (id) mapValue:(id)value
+{
+    if ([value isKindOfClass:[NSString class]]) {
+        id locationValue = [_location getValueForKey:value];
+        // v4.5.1 — for placeholder keys ("@time", "@events", "@battery", ...), if the location
+        // has no value, return NSNull instead of leaking the literal "@events" string to the
+        // backend. For non-placeholder static strings (e.g. a `deviceId` literal in postTemplate)
+        // keep the previous behaviour and return the string as-is.
+        if ([value hasPrefix:@"@"]) {
+            return locationValue != nil ? locationValue : [NSNull null];
+        }
+        return locationValue != nil ? locationValue : value;
+    } else if ([value isKindOfClass:[NSDictionary class]]) {
+        return [self withDictionary:value];
+    } else if ([value isKindOfClass:[NSArray class]]) {
+        return [self withArray:value];
+    }
+
+    return value;
+}
+
+- (NSDictionary*) withDictionary:(NSDictionary*)values
+{
+    NSMutableDictionary *dict = [NSMutableDictionary dictionaryWithCapacity:values.count];
+
+    for (id key in values) {
+        id value = [values objectForKey:key];
+        [dict setObject:[self mapValue:value] forKey:key];
+    }
+
+    return dict;
+}
+
+- (NSArray*) withArray:(NSArray*)values
+{
+    NSMutableArray *locationArray = [[NSMutableArray alloc] initWithCapacity:values.count];
+
+    for (id value in values) {
+        [locationArray addObject:[self mapValue:value]];
+    }
+
+    return locationArray;
+}
+
++ (instancetype) map:(MAURLocation*)location
+{
+    MAURLocationMapper *instance = [[MAURLocationMapper alloc] init];
+    instance->_location = location;
+    return instance;
+}
+@end
+
+
+@implementation MAURLocation
+
+@synthesize locationId, time, accuracy, altitudeAccuracy, speed, heading, altitude, latitude, longitude, provider, locationProvider, radius, isValid, recordedAt, simulated, drivingEvents, batteryLevel, isCharging;
+
++ (instancetype) fromCLLocation:(CLLocation*)location;
+{
+    MAURLocation *instance = [[MAURLocation alloc] init];
+
+    instance.time = location.timestamp;
+    instance.accuracy = [NSNumber numberWithDouble:location.horizontalAccuracy];
+    instance.altitudeAccuracy = [NSNumber numberWithDouble:location.verticalAccuracy];
+    instance.speed = [NSNumber numberWithDouble:location.speed];
+    instance.heading = [NSNumber numberWithDouble:location.course]; // will be deprecated
+    instance.altitude = [NSNumber numberWithDouble:location.altitude];
+    instance.latitude = [NSNumber numberWithDouble:location.coordinate.latitude];
+    instance.longitude = [NSNumber numberWithDouble:location.coordinate.longitude];
+
+    if (@available(iOS 15.0, *)) {
+        if (location.sourceInformation != nil && location.sourceInformation.isSimulatedBySoftware) {
+            instance.simulated = @YES;
+        } else {
+            instance.simulated = @NO;
+        }
+    }
+
+    return instance;
+}
+
++ (NSTimeInterval) locationAge:(CLLocation*)location
+{
+    return -[location.timestamp timeIntervalSinceNow];
+}
+
++ (NSDictionary*) toDictionary:(CLLocation*)location;
+{
+    NSMutableDictionary *dict = [NSMutableDictionary dictionaryWithCapacity:10];
+
+    NSNumber* timestamp = [NSNumber numberWithDouble:([location.timestamp timeIntervalSince1970] * 1000)];
+    [dict setObject:timestamp forKey:@"time"];
+    [dict setObject:[NSNumber numberWithDouble:location.horizontalAccuracy] forKey:@"accuracy"];
+    [dict setObject:[NSNumber numberWithDouble:location.verticalAccuracy] forKey:@"altitudeAccuracy"];
+    [dict setObject:[NSNumber numberWithDouble:location.speed] forKey:@"speed"];
+    [dict setObject:[NSNumber numberWithDouble:location.course] forKey:@"heading"];
+    [dict setObject:[NSNumber numberWithDouble:location.course] forKey:@"bearing"];
+    [dict setObject:[NSNumber numberWithDouble:location.altitude] forKey:@"altitude"];
+    [dict setObject:[NSNumber numberWithDouble:location.coordinate.latitude] forKey:@"latitude"];
+    [dict setObject:[NSNumber numberWithDouble:location.coordinate.longitude] forKey:@"longitude"];
+
+    return dict;
+}
+
+- (instancetype) init
+{
+    self = [super init];
+    if (self != nil) {
+        [self commonInit];
+    }
+
+    return self;
+}
+
+- (void) commonInit
+{
+    isValid = true;
+}
+
+/*
+ * Age of location measured from now in seconds
+ *
+ */
+- (NSTimeInterval) locationAge
+{
+    return -[time timeIntervalSinceNow];
+}
+
+- (NSDictionary*) toDictionaryWithId
+{
+    NSMutableDictionary *dict = (NSMutableDictionary*)[self toDictionary];
+
+    // locationId is solely for internal purposes like deleteLocation method!!!
+    if (locationId != nil) [dict setObject:locationId forKey:@"id"];
+
+    return dict;
+}
+
+- (NSMutableDictionary*) toDictionary
+{
+    NSMutableDictionary *dict = [NSMutableDictionary dictionaryWithCapacity:13];
+
+    if (time != nil) [dict setObject:[NSNumber numberWithDouble:([time timeIntervalSince1970] * 1000)] forKey:@"time"];
+    if (accuracy != nil) [dict setObject:accuracy forKey:@"accuracy"];
+    if (altitudeAccuracy != nil) [dict setObject:altitudeAccuracy forKey:@"altitudeAccuracy"];
+    if (speed != nil) [dict setObject:speed forKey:@"speed"];
+    if (heading != nil) [dict setObject:heading forKey:@"heading"]; // @deprecated
+    if (heading != nil) [dict setObject:heading forKey:@"bearing"];
+    if (altitude != nil) [dict setObject:altitude forKey:@"altitude"];
+    if (latitude != nil) [dict setObject:latitude forKey:@"latitude"];
+    if (longitude != nil) [dict setObject:longitude forKey:@"longitude"];
+    if (provider != nil) [dict setObject:provider forKey:@"provider"];
+    if (locationProvider != nil) [dict setObject:locationProvider forKey:@"locationProvider"];
+    if (radius != nil) [dict setObject:radius forKey:@"radius"];
+    if (recordedAt != nil) [dict setObject:[NSNumber numberWithDouble:([recordedAt timeIntervalSince1970] * 1000)] forKey:@"recordedAt"];
+    if (simulated != nil) [dict setObject:simulated forKey:@"simulated"];
+    // v4.3 — driving events anexados a este fix
+    if (drivingEvents != nil && [drivingEvents count] > 0) [dict setObject:drivingEvents forKey:@"events"];
+    // v4.4 — battery snapshot
+    if (batteryLevel != nil) [dict setObject:batteryLevel forKey:@"battery"];
+    if (isCharging != nil)   [dict setObject:isCharging   forKey:@"isCharging"];
+
+    return dict;
+}
+
+- (id) getValueForKey:(id)key
+{
+    if (key == nil || ![key isKindOfClass:[NSString class]]) {
+        return nil;
+    }
+
+    if ([key isEqualToString:@"@id"]) {
+        return locationId;
+    }
+    if ([key isEqualToString:@"@time"]) {
+        return [NSNumber numberWithDouble:([time timeIntervalSince1970] * 1000)];
+    }
+    if ([key isEqualToString:@"@accuracy"]) {
+        return accuracy;
+    }
+    if ([key isEqualToString:@"@altitudeAccuracy"]) {
+        return altitudeAccuracy;
+    }
+    if ([key isEqualToString:@"@speed"]) {
+        return speed;
+    }
+    if ([key isEqualToString:@"@heading"]) {
+        return heading;
+    }
+    if ([key isEqualToString:@"@bearing"]) {
+        return heading;
+    }
+    if ([key isEqualToString:@"@altitude"]) {
+        return altitude;
+    }
+    if ([key isEqualToString:@"@latitude"]) {
+        return latitude;
+    }
+    if ([key isEqualToString:@"@longitude"]) {
+        return longitude;
+    }
+    if ([key isEqualToString:@"@provider"]) {
+        return provider;
+    }
+    if ([key isEqualToString:@"@locationProvider"]) {
+        return locationProvider;
+    }
+    if ([key isEqualToString:@"@radius"]) {
+        return radius;
+    }
+    if ([key isEqualToString:@"@recordedAt"]) {
+        return [NSNumber numberWithDouble:([recordedAt timeIntervalSince1970] * 1000)];
+    }
+    if ([key isEqualToString:@"@simulated"]) {
+        return simulated;
+    }
+    // v4.3 — driving events array (nil when no events on this fix; mapper drops nil keys).
+    if ([key isEqualToString:@"@events"]) {
+        return (drivingEvents != nil && [drivingEvents count] > 0) ? drivingEvents : nil;
+    }
+    // v4.4 — battery snapshot
+    if ([key isEqualToString:@"@battery"])    return batteryLevel;
+    if ([key isEqualToString:@"@isCharging"]) return isCharging;
+
+    return nil;
+}
+
+- (id) toResultFromTemplate:(id)locationTemplate
+{
+    if ([locationTemplate isKindOfClass:[NSArray class]]) {
+        MAURLocationMapper *mapper = [MAURLocationMapper map:self];
+        return [mapper withArray:locationTemplate];
+    } else if ([locationTemplate isKindOfClass:[NSDictionary class]]) {
+        MAURLocationMapper *mapper = [MAURLocationMapper map:self];
+        return [mapper withDictionary:locationTemplate];
+    }
+    
+    return [self toDictionary];
+}
+
+- (CLLocationCoordinate2D) coordinate
+{
+    CLLocationCoordinate2D coordinate;
+    coordinate.latitude = [latitude doubleValue];
+    coordinate.longitude = [longitude doubleValue];
+    return coordinate;
+}
+
+- (double) distanceFromLocation:(MAURLocation*)location
+{
+    const float EarthRadius = 6378137.0f;
+    double a_lat = [self.latitude doubleValue];
+    double a_lon = [self.longitude doubleValue];
+    double b_lat = [location.latitude doubleValue];
+    double b_lon = [location.longitude doubleValue];
+    double dtheta = (a_lat - b_lat) * (M_PI / 180.0);
+    double dlambda = (a_lon - b_lon) * (M_PI / 180.0);
+    double mean_t = (a_lat + b_lat) * (M_PI / 180.0) / 2.0;
+    double cos_meant = cosf(mean_t);
+
+    return sqrtf((EarthRadius * EarthRadius) * (dtheta * dtheta + cos_meant * cos_meant * dlambda * dlambda));
+}
+
+/**
+ * Determines whether instance is better then Location reading
+ * @param location  The new Location that you want to evaluate
+ * Note: code taken from https://developer.android.com/guide/topics/location/strategies.html
+ */
+- (BOOL) isBetterLocation:(MAURLocation*)location
+{
+    if (location == nil) {
+        // A instance location is always better than no location
+        return NO;
+    }
+
+    // Check whether the new location fix is newer or older
+    NSTimeInterval timeDelta = [self.time timeIntervalSinceDate:location.time];
+    BOOL isSignificantlyNewer = timeDelta > TWO_MINUTES;
+    BOOL isSignificantlyOlder = timeDelta < -TWO_MINUTES;
+    BOOL isNewer = timeDelta > 0;
+
+    // If it's been more than two minutes since the current location, use the new location
+    // because the user has likely moved
+    if (isSignificantlyNewer) {
+        return YES;
+        // If the new location is more than two minutes older, it must be worse
+    } else if (isSignificantlyOlder) {
+        return NO;
+    }
+
+    // Check whether the new location fix is more or less accurate
+    NSInteger accuracyDelta = [self.accuracy integerValue] - [location.accuracy integerValue];
+    BOOL isLessAccurate = accuracyDelta > 0;
+    BOOL isMoreAccurate = accuracyDelta < 0;
+    BOOL isSignificantlyLessAccurate = accuracyDelta > 200;
+
+    // Check if the old and new location are from the same provider
+    BOOL isFromSameProvider = YES; //TODO: check
+
+    // Determine location quality using a combination of timeliness and accuracy
+    if (isMoreAccurate) {
+        return YES;
+    } else if (isNewer && !isLessAccurate) {
+        return YES;
+    } else if (isNewer && !isSignificantlyLessAccurate && isFromSameProvider) {
+        return YES;
+    }
+
+    return NO;
+}
+
+- (BOOL) isBeyond:(MAURLocation*)location radius:(NSInteger)definedRadius
+{
+    double pointDistance = [self distanceFromLocation:location];
+    return (pointDistance - [self.accuracy doubleValue] - [location.accuracy doubleValue]) > definedRadius;
+}
+
+- (BOOL) hasAccuracy
+{
+    if (accuracy == nil || accuracy < 0) return NO;
+    return YES;
+}
+
+- (BOOL) hasTime
+{
+    if (time != nil && [time timeIntervalSinceNow] > MAX_SECONDS_FROM_NOW) return NO;
+    return YES;
+}
+
+- (NSString *) description
+{
+    return [NSString stringWithFormat:@"Location: id=%@ time=%@ lat=%@ lon=%@ accu=%@ aaccu=%@ speed=%@ bear=%@ alt=%@", locationId, time, latitude, longitude, accuracy, altitudeAccuracy, speed, heading, altitude];
+}
+
+-(id) copyWithZone: (NSZone *) zone
+{
+    MAURLocation *copy = [[[self class] allocWithZone: zone] init];
+    if (copy) {
+        copy.time = time;
+        copy.accuracy = accuracy;
+        copy.altitudeAccuracy = altitudeAccuracy;
+        copy.speed = speed;
+        copy.heading = heading;
+        copy.altitude = altitude;
+        copy.latitude = latitude;
+        copy.longitude = longitude;
+        copy.provider = provider;
+        copy.locationProvider = locationProvider;
+        copy.radius = radius;
+        copy.isValid = isValid;
+        copy.simulated = simulated;
+        // v4.3: copy driving events array reference (transient; mutating one affects the other,
+        // but in practice the original is discarded right after the copy is posted).
+        copy.drivingEvents = drivingEvents != nil ? [drivingEvents mutableCopy] : nil;
+        copy.batteryLevel = batteryLevel;
+        copy.isCharging = isCharging;
+    }
+
+    return copy;
+}
+
+@end

package/ios/common/BackgroundGeolocation/MAURLocationContract.h

@@ -0,0 +1,38 @@
+//
+//  MAURLocationContract.h
+//  BackgroundGeolocation
+//
+//  Created by Marian Hello on 23/06/16.
+//  Copyright © 2016 mauron85. All rights reserved.
+//
+
+#ifndef MAURLocationContract_h
+#define MAURLocationContract_h
+
+#define LC_TABLE_NAME                      "location"
+#define LC_COLUMN_NAME_ID                  "id"
+#define LC_COLUMN_NAME_NULLABLE            "NULLHACK"
+#define LC_COLUMN_NAME_TIME                "time"
+#define LC_COLUMN_NAME_ACCURACY            "accuracy"
+#define LC_COLUMN_NAME_SPEED               "speed"
+#define LC_COLUMN_NAME_BEARING             "bearing"
+#define LC_COLUMN_NAME_ALTITUDE            "altitude"
+#define LC_COLUMN_NAME_LATITUDE            "latitude"
+#define LC_COLUMN_NAME_LONGITUDE           "longitude"
+#define LC_COLUMN_NAME_PROVIDER            "provider"
+#define LC_COLUMN_NAME_LOCATION_PROVIDER   "service_provider"
+#define LC_COLUMN_NAME_STATUS              "valid"
+#define LC_COLUMN_NAME_RECORDED_AT         "recorded_at"
+// v4.5 — survive sync queue
+#define LC_COLUMN_NAME_EVENTS_JSON         "events_json"
+#define LC_COLUMN_NAME_BATTERY_LEVEL       "battery_level"
+#define LC_COLUMN_NAME_IS_CHARGING         "is_charging"
+
+@interface MAURLocationContract : NSObject
+
++ (NSString*) createTableSQL;
+
+@end
+
+
+#endif /* MAURLocationContract_h */

package/ios/common/BackgroundGeolocation/MAURLocationContract.m

@@ -0,0 +1,39 @@
+//
+//  MAURLocationContract.m
+//  BackgroundGeolocation
+//
+//  Created by Marian Hello on 23/06/16.
+//  Copyright © 2016 mauron85. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "MAURSQLiteHelper.h"
+#import "MAURLocationContract.h"
+
+@implementation MAURLocationContract
+
++ (NSString*) createTableSQL
+{
+    NSArray *columns = @[
+        @{ @"name": @LC_COLUMN_NAME_ID, @"type": [SQLPrimaryKeyAutoIncColumnType sqlColumnWithType: kInteger]},
+        @{ @"name": @LC_COLUMN_NAME_TIME, @"type": [SQLColumnType sqlColumnWithType: kReal]},
+        @{ @"name": @LC_COLUMN_NAME_ACCURACY, @"type": [SQLColumnType sqlColumnWithType: kReal]},
+        @{ @"name": @LC_COLUMN_NAME_SPEED, @"type": [SQLColumnType sqlColumnWithType: kReal]},
+        @{ @"name": @LC_COLUMN_NAME_BEARING, @"type": [SQLColumnType sqlColumnWithType: kReal]},
+        @{ @"name": @LC_COLUMN_NAME_ALTITUDE, @"type": [SQLColumnType sqlColumnWithType: kReal]},
+        @{ @"name": @LC_COLUMN_NAME_LATITUDE, @"type": [SQLColumnType sqlColumnWithType: kReal]},
+        @{ @"name": @LC_COLUMN_NAME_LONGITUDE, @"type": [SQLColumnType sqlColumnWithType: kReal]},
+        @{ @"name": @LC_COLUMN_NAME_PROVIDER, @"type": [SQLColumnType sqlColumnWithType: kText]},
+        @{ @"name": @LC_COLUMN_NAME_LOCATION_PROVIDER, @"type": [SQLColumnType sqlColumnWithType: kText]},
+        @{ @"name": @LC_COLUMN_NAME_STATUS, @"type": [SQLColumnType sqlColumnWithType: kInteger]},
+        @{ @"name": @LC_COLUMN_NAME_RECORDED_AT, @"type": [SQLColumnType sqlColumnWithType: kInteger]},
+        // v4.5 — survive sync queue
+        @{ @"name": @LC_COLUMN_NAME_EVENTS_JSON, @"type": [SQLColumnType sqlColumnWithType: kText]},
+        @{ @"name": @LC_COLUMN_NAME_BATTERY_LEVEL, @"type": [SQLColumnType sqlColumnWithType: kInteger]},
+        @{ @"name": @LC_COLUMN_NAME_IS_CHARGING, @"type": [SQLColumnType sqlColumnWithType: kInteger]}
+    ];
+    
+    return [MAURSQLiteHelper createTableSqlStatement:@LC_TABLE_NAME columns:columns];
+}
+
+@end