@josuelmm/capacitor-background-geolocation 1.0.0

package/ios/common/BackgroundGeolocation/MAURSQLiteLocationDAO.m

@@ -0,0 +1,520 @@
+//
+//  MAURSQLiteLocationDAO.m
+//  BackgroundGeolocation
+//
+//  Created by Marian Hello on 10/06/16.
+//
+
+#import <sqlite3.h>
+#import <CoreLocation/CoreLocation.h>
+#import "MAURSQLiteHelper.h"
+#import "MAURGeolocationOpenHelper.h"
+#import "MAURSQLiteLocationDAO.h"
+#import "MAURLocationContract.h"
+
+@implementation MAURSQLiteLocationDAO {
+    FMDatabaseQueue* queue;
+    MAURGeolocationOpenHelper *helper;
+}
+
+#pragma mark Singleton Methods
+
++ (instancetype) sharedInstance
+{
+    static MAURSQLiteLocationDAO *instance = nil;
+    static dispatch_once_t onceToken;
+    dispatch_once(&onceToken, ^{
+        instance = [[self alloc] init];
+    });
+
+    return instance;
+}
+
+- (id) init {
+    if (self = [super init]) {
+        helper = [[MAURGeolocationOpenHelper alloc] init];
+        queue = [helper getWritableDatabase];
+    }
+    return self;
+}
+
+- (NSArray<MAURLocation*>*) getValidLocations
+{
+    __block NSMutableArray* locations = [[NSMutableArray alloc] init];
+    
+    NSString *sql = [[self getLocationSelectString] stringByAppendingString: @" WHERE " @LC_COLUMN_NAME_STATUS @" = ? ORDER BY " @LC_COLUMN_NAME_RECORDED_AT];
+
+    [queue inDatabase:^(FMDatabase *database) {
+        FMResultSet *rs = [database executeQuery:sql, [NSString stringWithFormat:@"%ld", MAURLocationPostPending]];
+        while([rs next]) {
+            MAURLocation *location = [self convertToLocation:rs];
+            [locations addObject:location];
+        }
+        // TODO
+        // NSLog(@"Retrieving locations failed code: %d: message: %s", sqlite3_errcode(database), sqlite3_errmsg(database));
+
+        [rs close];
+    }];
+
+    return locations;
+}
+
+- (NSArray<MAURLocation*>*) getAllLocations
+{
+    __block NSMutableArray* locations = [[NSMutableArray alloc] init];
+
+    NSString *sql = [[self getLocationSelectString] stringByAppendingString: @" ORDER BY " @LC_COLUMN_NAME_RECORDED_AT];
+
+    [queue inDatabase:^(FMDatabase *database) {
+        FMResultSet *rs = [database executeQuery:sql];
+        while([rs next]) {
+            MAURLocation *location = [self convertToLocation:rs];
+            [locations addObject:location];
+        }
+        // TODO
+        // NSLog(@"Retrieving locations failed code: %d: message: %s", sqlite3_errcode(database), sqlite3_errmsg(database));
+
+        [rs close];
+    }];
+
+    return locations;
+}
+
+- (NSArray<MAURLocation*>*) getLocationsForSync
+{
+    __block NSMutableArray* locations = [[NSMutableArray alloc] init];
+
+    [queue inTransaction:^(FMDatabase *database, BOOL *rollback) {
+        NSString *sql = [[self getLocationSelectString] stringByAppendingString: @" WHERE " @LC_COLUMN_NAME_STATUS @" = ? ORDER BY " @LC_COLUMN_NAME_RECORDED_AT];
+
+        FMResultSet *rs = [database executeQuery:sql, [NSString stringWithFormat:@"%ld", MAURLocationPostPending]];
+        while([rs next]) {
+            MAURLocation *location = [self convertToLocation:rs];
+            [locations addObject:location];
+        }
+        [rs close];
+
+        // v4.5.1 FIX (CRITICAL): mark the rows we just selected as SyncPending — NOT Deleted.
+        // The previous code UPDATEd the WHOLE table to Deleted before the upload had even started,
+        // losing every fix on HTTP failure / network drop. Now:
+        //   PostPending → SyncPending  (in-flight, do not re-include)
+        //   on success in the network task: SyncPending → Deleted (deleteSyncedLocationsBefore:)
+        //   on failure in the network task: SyncPending → PostPending (restoreFailedSyncLocations)
+        NSString *upd = @"UPDATE " @LC_TABLE_NAME @" SET " @LC_COLUMN_NAME_STATUS @" = ? WHERE " @LC_COLUMN_NAME_STATUS @" = ?";
+        if (![database executeUpdate:upd,
+                [NSString stringWithFormat:@"%ld", MAURLocationSyncPending],
+                [NSString stringWithFormat:@"%ld", MAURLocationPostPending]]) {
+            NSLog(@"Marking PostPending → SyncPending failed code: %d: message: %@", [database lastErrorCode], [database lastErrorMessage]);
+        }
+    }];
+
+    return locations;
+
+}
+
+- (NSNumber*) getLocationsForSyncCount
+{
+    __block NSNumber* rowCount = nil;
+
+    [queue inTransaction:^(FMDatabase *database, BOOL *rollback) {
+        NSString *sql = @"SELECT COUNT(*) FROM " @LC_TABLE_NAME @" WHERE " @LC_COLUMN_NAME_STATUS @" = ?";
+
+        FMResultSet *rs = [database executeQuery:sql, [NSString stringWithFormat:@"%ld", MAURLocationPostPending]];
+        if ([rs next]) {
+            rowCount = [NSNumber numberWithInt:[rs intForColumnIndex:0]];
+        }
+        [rs close];
+    }];
+
+    return rowCount;
+}
+
+- (NSNumber*) persistLocation:(MAURLocation*)location intoDatabase:(FMDatabase*)database
+{
+    NSNumber* locationId = nil;
+    NSTimeInterval timestamp = [[NSDate date] timeIntervalSince1970];
+    NSNumber *recordedAt = [NSNumber numberWithDouble:timestamp];
+
+    NSString *sql = @"INSERT INTO " @LC_TABLE_NAME @" ("
+    @LC_COLUMN_NAME_TIME
+    @COMMA_SEP @LC_COLUMN_NAME_ACCURACY
+    @COMMA_SEP @LC_COLUMN_NAME_SPEED
+    @COMMA_SEP @LC_COLUMN_NAME_BEARING
+    @COMMA_SEP @LC_COLUMN_NAME_ALTITUDE
+    @COMMA_SEP @LC_COLUMN_NAME_LATITUDE
+    @COMMA_SEP @LC_COLUMN_NAME_LONGITUDE
+    @COMMA_SEP @LC_COLUMN_NAME_PROVIDER
+    @COMMA_SEP @LC_COLUMN_NAME_LOCATION_PROVIDER
+    @COMMA_SEP @LC_COLUMN_NAME_STATUS
+    @COMMA_SEP @LC_COLUMN_NAME_RECORDED_AT
+    @COMMA_SEP @LC_COLUMN_NAME_EVENTS_JSON
+    @COMMA_SEP @LC_COLUMN_NAME_BATTERY_LEVEL
+    @COMMA_SEP @LC_COLUMN_NAME_IS_CHARGING
+    @") VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?)";
+
+    // v4.5: serialize driving events array to JSON for SQLite storage.
+    NSString *eventsJson = nil;
+    if (location.drivingEvents != nil && [location.drivingEvents count] > 0) {
+        NSError *jerr = nil;
+        NSData *jd = [NSJSONSerialization dataWithJSONObject:location.drivingEvents options:0 error:&jerr];
+        if (jd != nil) eventsJson = [[NSString alloc] initWithData:jd encoding:NSUTF8StringEncoding];
+    }
+
+    BOOL success = [database executeUpdate:sql,
+        [NSNumber numberWithDouble:[location.time timeIntervalSince1970]],
+        location.accuracy,
+        location.speed,
+        location.heading,
+        location.altitude,
+        location.latitude,
+        location.longitude,
+        location.provider ?: [NSNull null],
+        location.locationProvider ?: [NSNull null],
+        location.isValid == YES ? @(1) : @(0),
+        recordedAt,
+        eventsJson ?: [NSNull null],
+        location.batteryLevel ?: [NSNull null],
+        location.isCharging ?: [NSNull null]
+    ];
+
+    if (success) {
+        locationId = [NSNumber numberWithLongLong:[database lastInsertRowId]];
+    } else {
+        NSLog(@"Inserting location %@ failed code: %d: message: %@", location.time, [database lastErrorCode], [database lastErrorMessage]);
+    }
+
+    return locationId;
+}
+
+- (NSNumber*) persistLocation:(MAURLocation*)location
+{
+    __block NSNumber* locationId = nil;
+
+    [queue inDatabase:^(FMDatabase *database) {
+        locationId = [self persistLocation:location intoDatabase:database];
+    }];
+
+    return locationId;
+}
+
+- (NSNumber*) persistLocation:(MAURLocation*)location limitRows:(NSInteger)maxRows
+{
+    __block NSNumber *locationId;
+    NSTimeInterval timestamp = [[NSDate date] timeIntervalSince1970];
+    NSNumber *recordedAt = [NSNumber numberWithDouble:timestamp];
+
+    [queue inDatabase:^(FMDatabase *database) {
+        NSInteger rowCount = 0;
+        NSString *sql = @"SELECT COUNT(*) FROM " @LC_TABLE_NAME;
+
+        FMResultSet *rs = [database executeQuery:sql];
+        if ([rs next]) {
+            rowCount = [rs intForColumnIndex:0];
+        }
+        [rs close];
+
+        if (rowCount < maxRows) {
+            locationId = [self persistLocation:location intoDatabase:database];
+            return;
+        } else if (rowCount > maxRows) {
+            sql = [NSString stringWithFormat:@"DELETE FROM %1$@ WHERE %2$@ IN (SELECT %2$@ FROM %1$@ ORDER BY %3$@ LIMIT %4$ld);VACUUM;",
+                   @LC_TABLE_NAME, @LC_COLUMN_NAME_ID, @LC_COLUMN_NAME_RECORDED_AT, (rowCount - maxRows)];
+            if (![database executeStatements:sql]) {
+                NSLog(@"%@ failed code: %d: message: %@", sql, [database lastErrorCode], [database lastErrorMessage]);
+            }
+        }
+
+        // get oldest location id to be overwritten
+        sql = @"SELECT MIN(" @LC_COLUMN_NAME_ID ") FROM " @LC_TABLE_NAME @" WHERE " @LC_COLUMN_NAME_RECORDED_AT
+        @" = (SELECT min(" @LC_COLUMN_NAME_RECORDED_AT @") FROM " @LC_TABLE_NAME @" )";
+        rs = [database executeQuery:sql];
+        if ([rs next]) {
+            locationId = [NSNumber numberWithLongLong:[rs longLongIntForColumnIndex:0]];
+        }
+        [rs close];
+
+        sql = @"UPDATE " @LC_TABLE_NAME @" SET "
+        @LC_COLUMN_NAME_TIME @EQ_BIND
+        @COMMA_SEP @LC_COLUMN_NAME_ACCURACY @EQ_BIND
+        @COMMA_SEP @LC_COLUMN_NAME_SPEED @EQ_BIND
+        @COMMA_SEP @LC_COLUMN_NAME_BEARING @EQ_BIND
+        @COMMA_SEP @LC_COLUMN_NAME_ALTITUDE @EQ_BIND
+        @COMMA_SEP @LC_COLUMN_NAME_LATITUDE @EQ_BIND
+        @COMMA_SEP @LC_COLUMN_NAME_LONGITUDE @EQ_BIND
+        @COMMA_SEP @LC_COLUMN_NAME_PROVIDER @EQ_BIND
+        @COMMA_SEP @LC_COLUMN_NAME_LOCATION_PROVIDER @EQ_BIND
+        @COMMA_SEP @LC_COLUMN_NAME_STATUS @EQ_BIND
+        @COMMA_SEP @LC_COLUMN_NAME_RECORDED_AT @EQ_BIND
+        @COMMA_SEP @LC_COLUMN_NAME_EVENTS_JSON @EQ_BIND
+        @COMMA_SEP @LC_COLUMN_NAME_BATTERY_LEVEL @EQ_BIND
+        @COMMA_SEP @LC_COLUMN_NAME_IS_CHARGING @EQ_BIND
+        @" WHERE " @LC_COLUMN_NAME_ID @EQ_BIND;
+
+        // v4.5.1: serialize events for UPDATE path so old values don't bleed onto new locations
+        NSString *eventsJsonForUpdate = nil;
+        if (location.drivingEvents != nil && [location.drivingEvents count] > 0) {
+            NSError *jerr = nil;
+            NSData *jd = [NSJSONSerialization dataWithJSONObject:location.drivingEvents options:0 error:&jerr];
+            if (jd != nil) eventsJsonForUpdate = [[NSString alloc] initWithData:jd encoding:NSUTF8StringEncoding];
+        }
+
+        BOOL success = [database executeUpdate:sql,
+            [NSNumber numberWithDouble:[location.time timeIntervalSince1970]],
+            location.accuracy,
+            location.speed,
+            location.heading,
+            location.altitude,
+            location.latitude,
+            location.longitude,
+            location.provider ?: [NSNull null],
+            location.locationProvider ?: [NSNull null],
+            location.isValid == YES ? @(1) : @(0),
+            recordedAt,
+            eventsJsonForUpdate ?: [NSNull null],
+            location.batteryLevel ?: [NSNull null],
+            location.isCharging ?: [NSNull null],
+            locationId
+        ];
+
+        if (!success) {
+            NSLog(@"Inserting location %@ failed code: %d: message: %@", location.time, [database lastErrorCode], [database lastErrorMessage]);
+            locationId = [NSNumber numberWithInt:-1];
+        }
+
+    }];
+
+    return locationId;
+}
+
+- (BOOL) deleteLocation:(NSNumber*)locationId error:(NSError * __autoreleasing *)outError
+{
+    __block BOOL success;
+    NSString *sql = @"UPDATE " @LC_TABLE_NAME @" SET " @LC_COLUMN_NAME_STATUS @" = ? WHERE " @LC_COLUMN_NAME_ID @" = ?";
+
+    [queue inDatabase:^(FMDatabase *database) {
+        if ([database executeUpdate:sql, [NSString stringWithFormat:@"%ld", MAURLocationDeleted], locationId]) {
+            success = YES;
+        } else {
+            int errorCode = [database lastErrorCode];
+            NSString *errorMessage = [database lastErrorMessage];
+            NSLog(@"Delete location %@ failed code: %d: message: %@", locationId, errorCode, errorMessage);
+
+            if (outError != NULL) {
+                NSDictionary *errorDictionary = @{
+                                                  NSLocalizedDescriptionKey: NSLocalizedString(errorMessage, nil)
+                                                  };
+                *outError = [NSError errorWithDomain:Domain code:errorCode userInfo:errorDictionary];
+            }
+
+            success = NO;
+        }
+    }];
+
+    return success;
+}
+
+- (BOOL) deleteAllLocations:(NSError * __autoreleasing *)outError
+{
+    __block BOOL success;
+    NSString *sql = @"UPDATE " @LC_TABLE_NAME @" SET " @LC_COLUMN_NAME_STATUS @" = ?";
+
+    [queue inDatabase:^(FMDatabase *database) {
+        if ([database executeUpdate:sql, [NSString stringWithFormat:@"%ld", MAURLocationDeleted]]) {
+            success = YES;
+        } else {
+            int errorCode = [database lastErrorCode];
+            NSString *errorMessage = [database lastErrorMessage];
+            NSLog(@"Deleting all locations failed code: %d: message: %@", errorCode, errorMessage);
+
+            if (outError != NULL) {
+                NSDictionary *errorDictionary = @{
+                                                  NSLocalizedDescriptionKey: NSLocalizedString(errorMessage, nil)
+                                                  };
+                *outError = [NSError errorWithDomain:Domain code:errorCode userInfo:errorDictionary];
+            }
+
+            success = NO;
+        }
+    }];
+
+    return success;
+}
+
+- (BOOL) deleteSyncedLocationsBefore:(NSTimeInterval)cutoff error:(NSError * __autoreleasing *)outError
+{
+    __block BOOL success = YES;
+    // v4.5.1 — operate on SyncPending (the rows the network task is/was uploading), not on
+    // PostPending (those are still queued for real-time POST and must NOT be touched).
+    NSString *sql = @"UPDATE " @LC_TABLE_NAME
+        @" SET " @LC_COLUMN_NAME_STATUS @" = ? "
+        @" WHERE " @LC_COLUMN_NAME_STATUS @" = ? AND " @LC_COLUMN_NAME_RECORDED_AT @" <= ?";
+    [queue inDatabase:^(FMDatabase *database) {
+        if (![database executeUpdate:sql,
+                @(MAURLocationDeleted),
+                @(MAURLocationSyncPending),
+                @(cutoff)]) {
+            int errorCode = [database lastErrorCode];
+            NSString *errorMessage = [database lastErrorMessage];
+            NSLog(@"deleteSyncedLocationsBefore failed code: %d: message: %@", errorCode, errorMessage);
+            if (outError != NULL) {
+                *outError = [NSError errorWithDomain:Domain code:errorCode userInfo:@{ NSLocalizedDescriptionKey: errorMessage ?: @"" }];
+            }
+            success = NO;
+        }
+    }];
+    return success;
+}
+
+- (BOOL) restoreStaleSyncLocationsOlderThan:(NSTimeInterval)cutoff error:(NSError * __autoreleasing *)outError
+{
+    // v4.5.1 — rows left as SyncPending because the previous sync's task was killed
+    // (app suspended mid-upload, OS process death, manual kill) never reach their
+    // success/failure callback. Call at the start of each sync window to rescue them.
+    __block BOOL success = YES;
+    NSString *sql = @"UPDATE " @LC_TABLE_NAME
+        @" SET " @LC_COLUMN_NAME_STATUS @" = ? "
+        @" WHERE " @LC_COLUMN_NAME_STATUS @" = ? AND " @LC_COLUMN_NAME_RECORDED_AT @" < ?";
+    [queue inDatabase:^(FMDatabase *database) {
+        if (![database executeUpdate:sql,
+                @(MAURLocationPostPending),
+                @(MAURLocationSyncPending),
+                @(cutoff)]) {
+            int errorCode = [database lastErrorCode];
+            NSString *errorMessage = [database lastErrorMessage];
+            NSLog(@"restoreStaleSyncLocations failed code: %d: message: %@", errorCode, errorMessage);
+            if (outError != NULL) {
+                *outError = [NSError errorWithDomain:Domain code:errorCode userInfo:@{ NSLocalizedDescriptionKey: errorMessage ?: @"" }];
+            }
+            success = NO;
+        }
+    }];
+    return success;
+}
+
+- (BOOL) restoreFailedSyncLocations:(NSError * __autoreleasing *)outError
+{
+    // v4.5.1 — undo the in-flight transition: SyncPending → PostPending so the next sync window
+    // (or real-time post) re-tries them.
+    __block BOOL success = YES;
+    NSString *sql = @"UPDATE " @LC_TABLE_NAME @" SET " @LC_COLUMN_NAME_STATUS @" = ? WHERE " @LC_COLUMN_NAME_STATUS @" = ?";
+    [queue inDatabase:^(FMDatabase *database) {
+        if (![database executeUpdate:sql, @(MAURLocationPostPending), @(MAURLocationSyncPending)]) {
+            int errorCode = [database lastErrorCode];
+            NSString *errorMessage = [database lastErrorMessage];
+            NSLog(@"restoreFailedSyncLocations failed code: %d: message: %@", errorCode, errorMessage);
+            if (outError != NULL) {
+                *outError = [NSError errorWithDomain:Domain code:errorCode userInfo:@{ NSLocalizedDescriptionKey: errorMessage ?: @"" }];
+            }
+            success = NO;
+        }
+    }];
+    return success;
+}
+
+- (BOOL) deletePendingSyncLocations:(NSError * __autoreleasing *)outError
+{
+    __block BOOL success = YES;
+    NSString *sql = @"UPDATE " @LC_TABLE_NAME @" SET " @LC_COLUMN_NAME_STATUS @" = ? WHERE " @LC_COLUMN_NAME_STATUS @" = ?";
+
+    [queue inDatabase:^(FMDatabase *database) {
+        if (![database executeUpdate:sql, [NSString stringWithFormat:@"%ld", MAURLocationDeleted], [NSString stringWithFormat:@"%ld", MAURLocationPostPending]]) {
+            int errorCode = [database lastErrorCode];
+            NSString *errorMessage = [database lastErrorMessage];
+            NSLog(@"deletePendingSyncLocations failed code: %d: message: %@", errorCode, errorMessage);
+            if (outError != NULL) {
+                *outError = [NSError errorWithDomain:Domain code:errorCode userInfo:@{ NSLocalizedDescriptionKey: errorMessage ?: @"" }];
+            }
+            success = NO;
+        }
+    }];
+
+    return success;
+}
+
+- (BOOL) clearDatabase
+{
+    __block BOOL success;
+
+    [queue inDatabase:^(FMDatabase *database) {
+        NSString *sql = [NSString stringWithFormat: @"DROP TABLE %@", @LC_TABLE_NAME];
+        if (![database executeStatements:sql]) {
+            NSLog(@"%@ failed code: %d: message: %@", sql, [database lastErrorCode], [database lastErrorMessage]);
+        }
+        sql = [MAURLocationContract createTableSQL];
+        if (![database executeStatements:sql]) {
+            NSLog(@"%@ failed code: %d: message: %@", sql, [database lastErrorCode], [database lastErrorMessage]);
+            success = NO;
+        } else {
+            success = YES;
+        }
+    }];
+
+    return success;
+}
+
+- (NSString*) getDatabaseName
+{
+    return [helper getDatabaseName];
+}
+
+- (NSString*) getDatabasePath
+{
+    return [helper getDatabasePath];
+}
+
+- (NSString*) getLocationSelectString {
+    return @"SELECT " @LC_COLUMN_NAME_ID
+    @COMMA_SEP @LC_COLUMN_NAME_TIME
+    @COMMA_SEP @LC_COLUMN_NAME_ACCURACY
+    @COMMA_SEP @LC_COLUMN_NAME_SPEED
+    @COMMA_SEP @LC_COLUMN_NAME_BEARING
+    @COMMA_SEP @LC_COLUMN_NAME_ALTITUDE
+    @COMMA_SEP @LC_COLUMN_NAME_LATITUDE
+    @COMMA_SEP @LC_COLUMN_NAME_LONGITUDE
+    @COMMA_SEP @LC_COLUMN_NAME_PROVIDER
+    @COMMA_SEP @LC_COLUMN_NAME_LOCATION_PROVIDER
+    @COMMA_SEP @LC_COLUMN_NAME_STATUS
+    @COMMA_SEP @LC_COLUMN_NAME_RECORDED_AT
+    @COMMA_SEP @LC_COLUMN_NAME_EVENTS_JSON
+    @COMMA_SEP @LC_COLUMN_NAME_BATTERY_LEVEL
+    @COMMA_SEP @LC_COLUMN_NAME_IS_CHARGING
+    @" FROM " @LC_TABLE_NAME;
+}
+
+- (MAURLocation*) convertToLocation:(FMResultSet*)rs {
+    MAURLocation *location = [[MAURLocation alloc] init];
+    location.locationId = [NSNumber numberWithLongLong:[rs longLongIntForColumnIndex:0]];
+    NSTimeInterval timestamp = [rs doubleForColumnIndex:1];
+    location.time = [NSDate dateWithTimeIntervalSince1970:timestamp];
+    location.accuracy = [NSNumber numberWithDouble:[rs doubleForColumnIndex:2]];
+    location.speed = [NSNumber numberWithDouble:[rs doubleForColumnIndex:3]];
+    location.heading = [NSNumber numberWithDouble:[rs doubleForColumnIndex:4]];
+    location.altitude = [NSNumber numberWithDouble:[rs doubleForColumnIndex:5]];
+    location.latitude = [NSNumber numberWithDouble:[rs doubleForColumnIndex:6]];
+    location.longitude = [NSNumber numberWithDouble:[rs doubleForColumnIndex:7]];
+    location.provider = [rs stringForColumnIndex:8];
+    location.locationProvider = [NSNumber numberWithInt:[rs intForColumnIndex:9]];
+    location.isValid = [rs intForColumnIndex:10] == 1 ? YES : NO;
+    NSTimeInterval recordedAt = [rs longForColumnIndex:11];
+    location.recordedAt = [NSDate dateWithTimeIntervalSince1970:recordedAt];
+    // v4.5: events / battery / charging
+    NSString *eventsJson = [rs stringForColumnIndex:12];
+    if (eventsJson != nil && eventsJson.length > 0) {
+        NSError *jerr = nil;
+        id parsed = [NSJSONSerialization JSONObjectWithData:[eventsJson dataUsingEncoding:NSUTF8StringEncoding] options:NSJSONReadingMutableContainers error:&jerr];
+        if ([parsed isKindOfClass:[NSMutableArray class]]) location.drivingEvents = parsed;
+        else if ([parsed isKindOfClass:[NSArray class]]) location.drivingEvents = [parsed mutableCopy];
+    }
+    if (![rs columnIndexIsNull:13]) location.batteryLevel = @([rs intForColumnIndex:13]);
+    if (![rs columnIndexIsNull:14]) location.isCharging = @([rs intForColumnIndex:14] == 1);
+    return location;
+}
+
+- (void) dealloc {
+    [helper close];
+    [queue close];
+    helper = nil;
+    queue = nil;
+}
+
+@end

package/ios/common/BackgroundGeolocation/MAURSQLiteOpenHelper.h

@@ -0,0 +1,32 @@
+//
+//  MAURSQLiteOpenHelper.h
+//  version: 1.0.0
+//
+//  A helper class to manage database creation and version management.
+//  heavily inspired by Android implementation
+//  https://android.googlesource.com/platform/frameworks/base/+/refs/heads/master/core/java/android/database/sqlite/SQLiteOpenHelper.java
+//
+//  Note: Not for direct use, but as subclass instead (abstract class in java terminology)
+//
+//  Created by Marian Hello on 22/06/16.
+//
+
+#ifndef MAURSQLiteOpenHelper_h
+#define MAURSQLiteOpenHelper_h
+
+#import <Foundation/Foundation.h>
+#import "FMDB.h"
+
+@interface MAURSQLiteOpenHelper : NSObject
+
+- (instancetype)init:(NSString*)name version:(NSInteger)version;
+- (NSDictionary*) getDatabaseMetadata;
+- (NSString*) getDatabaseName;
+- (NSString*) getDatabasePath;
+- (FMDatabaseQueue*) getReadableDatabase;
+- (FMDatabaseQueue*) getWritableDatabase;
+- (void) close;
+
+@end
+
+#endif /* MAURSQLiteOpenHelper_h */