hypertrack-sdk-react-native 7.14.0 → 7.17.0

package/CHANGELOG.md

@@ -4,6 +4,22 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [7.17.0] - 2022-06-03
+### Changed
+- Updated HyperTrack Android SDK to 6.1.1
+
+## [7.16.0] - 2022-05-03
+### Changed
+- Updated HyperTrack Android SDK to [6.0.4](https://github.com/hypertrack/sdk-android/blob/master/CHANGELOG.md#604---2022-04-29)
+
+## [7.16.0] - 2022-05-03
+### Changed
+- Updated HyperTrack Android SDK to [6.0.4](https://github.com/hypertrack/sdk-android/blob/master/CHANGELOG.md#604---2022-04-29)
+
+## [7.15.0] - 2022-04-29
+### Added
+- Current location getter returns either the current location of the device or an outage reason for why current location is unavailable.
+
 ## [7.14.0] - 2022-03-24
 ### Changed
 - Updated HyperTrack Android SDK to [6.0.2](https://github.com/hypertrack/sdk-android/blob/master/CHANGELOG.md#602---2022-03-18)
@@ -236,6 +252,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [1.0.0] - 2019-06-07
 Initial release.
 
+[7.15.0]: https://github.com/hypertrack/sdk-react-native/releases/tag/7.15.0
+[7.14.0]: https://github.com/hypertrack/sdk-react-native/releases/tag/7.14.0
 [7.13.0]: https://github.com/hypertrack/sdk-react-native/releases/tag/7.13.0
 [7.12.1]: https://github.com/hypertrack/sdk-react-native/releases/tag/7.12.1
 [7.12.0]: https://github.com/hypertrack/sdk-react-native/releases/tag/7.12.0

package/README.md

@@ -2,8 +2,8 @@
 
 ![GitHub](https://img.shields.io/github/license/hypertrack/sdk-react-native.svg)
 ![npm](https://img.shields.io/npm/v/hypertrack-sdk-react-native.svg)
-[![iOS SDK](https://img.shields.io/badge/iOS%20SDK-4.9.0-brightgreen.svg)](https://cocoapods.org/pods/HyperTrack)
-![Android SDK](https://img.shields.io/badge/Android%20SDK-6.0.2-brightgreen.svg)
+[![iOS SDK](https://img.shields.io/badge/iOS%20SDK-4.11.1-brightgreen.svg)](https://cocoapods.org/pods/HyperTrack)
+![Android SDK](https://img.shields.io/badge/Android%20SDK-6.1.1-brightgreen.svg)
 
 [HyperTrack](https://www.hypertrack.com) lets you add live location tracking to your mobile app. Live location is made available along with ongoing activity, tracking controls and tracking outage with reasons.
 

package/android/build.gradle

@@ -15,7 +15,7 @@ def DEFAULT_COMPILE_SDK_VERSION = 30
 def DEFAULT_BUILD_TOOLS_VERSION = "30.0.2"
 def DEFAULT_MIN_SDK_VERSION = 21
 def DEFAULT_TARGET_SDK_VERSION = 30
-def DEFAULT_HYPERTRACK_SDK_VERSION = "6.0.2"
+def DEFAULT_HYPERTRACK_SDK_VERSION = "6.1.1"
 
 def HYPERTRACK_SDK_VERSION = rootProject.hasProperty('hypertrackSdkVersion') ? rootProject.hypertrackSdkVersion : DEFAULT_HYPERTRACK_SDK_VERSION
 

package/android/src/main/java/com/hypertrack/reactnative/androidsdk/HTSDKModule.java

@@ -12,27 +12,20 @@ import com.facebook.react.bridge.ReadableMap;
 import com.facebook.react.bridge.WritableMap;
 import com.facebook.react.module.annotations.ReactModule;
 import com.facebook.react.modules.core.DeviceEventManagerModule;
+import com.hypertrack.sdk.AsyncResultReceiver;
 import com.hypertrack.sdk.GeotagResult;
 import com.hypertrack.sdk.HyperTrack;
+import com.hypertrack.sdk.OutageReason;
+import com.hypertrack.sdk.Result;
 import com.hypertrack.sdk.TrackingError;
 import com.hypertrack.sdk.TrackingStateObserver;
 
-import java.io.Serializable;
-import java.util.HashMap;
 import java.util.Locale;
-import java.util.Map;
 
 
 @ReactModule(name = HTSDKModule.NAME)
 public class HTSDKModule extends ReactContextBaseJavaModule {
 
-    private static final String TAG = "HTSDKModule";
-
-    public static final String NAME = "HyperTrack";
-    public static final String LATITUDE = "latitude";
-    public static final String LONGITUDE = "longitude";
-    public static final String ACCURACY = "accuracy";
-
     public TrackingStateObserver.OnTrackingStateChangeListener trackingStateChangeListener;
     public HyperTrack sdkInstance;
 
@@ -56,7 +49,7 @@ public class HTSDKModule extends ReactContextBaseJavaModule {
             }
             promise.resolve(true);
         } catch (java.lang.Exception exception) {
-            Log.e(TAG, "Hypertrack SDK initialization failed.",  exception);
+            Log.e(TAG, "Hypertrack SDK initialization failed.", exception);
             String error = String.format(Locale.ENGLISH, "%d", RN_ERROR_INVALID_PUBLISHABLE_KEY);
             promise.reject(error, new Exception("Hypertrack SDK initialization failed."));
         }
@@ -213,6 +206,80 @@ public class HTSDKModule extends ReactContextBaseJavaModule {
         }
     }
 
+    @ReactMethod
+    public void getLocation(Promise promise) {
+        promise.resolve(locationResultToMap(sdkInstance.getLatestLocation()));
+    }
+
+    @ReactMethod
+    public void getCurrentLocation(final Promise promise) {
+        sdkInstance.getCurrentLocation(new AsyncResultReceiver<Location, OutageReason>() {
+            @Override
+            public void onResult(Result<Location, OutageReason> result) {
+                promise.resolve(locationResultToMap(result));
+            }
+        });
+    }
+
+    private WritableMap locationResultToMap(Result<Location, OutageReason> result) {
+        WritableMap resultMap = Arguments.createMap();
+        if (result.isSuccess()) {
+            Location location = result.getValue();
+            WritableMap locationMap = Arguments.createMap();
+            locationMap.putDouble(LATITUDE, location.getLatitude());
+            locationMap.putDouble(LONGITUDE, location.getLongitude());
+            resultMap.putMap(KEY_LOCATION, locationMap);
+        } else {
+            OutageReason outage = result.getError();
+            WritableMap errorMap = Arguments.createMap();
+            errorMap.putString(KEY_OUTAGE_CODE, getOutageName(outage));
+            resultMap.putMap(KEY_ERROR, errorMap);
+        }
+        return resultMap;
+    }
+
+    private String getOutageName(OutageReason outageReason) {
+        switch (outageReason) {
+            case MISSING_LOCATION_PERMISSION:
+                return OUTAGE_CODE_LOCATION_PERMISSIONS_DENIED;
+
+            case MISSING_ACTIVITY_PERMISSION:
+                return OUTAGE_CODE_MOTION_ACTIVITY_PERMISSIONS_DENIED;
+
+            case LOCATION_SERVICE_DISABLED:
+                return OUTAGE_CODE_LOCATION_SERVICES_DISABLED;
+
+            case NOT_TRACKING:
+                return OUTAGE_CODE_NOT_RUNNING;
+
+            case START_HAS_NOT_FINISHED:
+                return OUTAGE_CODE_STARTING;
+
+            case NO_GPS_SIGNAL:
+            case RESTART_REQUIRED:
+            default:
+                return OUTAGE_CODE_GPS_SIGNAL_LOST;
+        }
+    }
+
+    private static final String TAG = "HTSDKModule";
+
+    private static final String KEY_LOCATION = "location";
+    private static final String KEY_ERROR = "error";
+    private static final String KEY_OUTAGE_CODE = "code";
+
+    public static final String NAME = "HyperTrack";
+    public static final String LATITUDE = "latitude";
+    public static final String LONGITUDE = "longitude";
+    public static final String ACCURACY = "accuracy";
+
+    private static final String OUTAGE_CODE_LOCATION_PERMISSIONS_DENIED = "location_permissions_denied";
+    private static final String OUTAGE_CODE_LOCATION_SERVICES_DISABLED = "location_services_disabled";
+    private static final String OUTAGE_CODE_MOTION_ACTIVITY_PERMISSIONS_DENIED = "motion_activity_permissions_denied";
+    private static final String OUTAGE_CODE_NOT_RUNNING = "not_running";
+    private static final String OUTAGE_CODE_GPS_SIGNAL_LOST = "gps_signal_lost";
+    private static final String OUTAGE_CODE_STARTING = "starting";
+
     private static final int RN_ERROR_GENERAL = 0;
     private static final int RN_ERROR_INVALID_PUBLISHABLE_KEY = 1;
     private static final int RN_ERROR_AUTHORIZATION_FAILED = 2;

package/hypertrack-sdk-react-native.podspec

@@ -12,7 +12,7 @@ Pod::Spec.new do |s|
   s.source            = { :git => 'https://github.com/hypertrack/sdk-react-native.git' }
   s.platform          = :ios, '11.0'
   s.dependency        'React-Core'
-  s.dependency        'HyperTrack/Objective-C', '4.9.0'
+  s.dependency        'HyperTrack/Objective-C', '4.11.1'
   s.source_files      = "ios/*.{xcodeproj}", "ios/RNHyperTrack/*.{h,m}"
   s.cocoapods_version = '>= 1.10.0'
 end

package/ios/RNHyperTrack/RNHyperTrack.m

@@ -153,6 +153,61 @@ RCT_EXPORT_METHOD(isTracking:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromis
     resolve([NSNumber numberWithBool:[self.hyperTrack isRunning]]);
 }
 
+RCT_EXPORT_METHOD(getLocation:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject) {
+  HTLocationResult *locationResult = self.hyperTrack.location;
+
+  switch (locationResult.error) {
+    case HTLocationErrorNoError:
+      resolve(@{ @"location":  @{ @"latitude": [NSNumber numberWithDouble:locationResult.location.latitude], @"longitude": [NSNumber numberWithDouble:locationResult.location.longitude] } });
+      break;
+    case HTLocationErrorLocationPermissionsNotDetermined:
+      resolve(@{ @"error":  @{ @"code": @"location_permissions_not_determined" } });
+      break;
+    case HTLocationErrorLocationPermissionsCantBeAskedInBackground:
+      resolve(@{ @"error":  @{ @"code": @"location_permissions_cant_be_asked_in_background" } });
+      break;
+    case HTLocationErrorLocationPermissionsInsufficientForBackground:
+      resolve(@{ @"error":  @{ @"code": @"location_permissions_insufficient_for_background" } });
+      break;
+    case HTLocationErrorLocationPermissionsRestricted:
+      resolve(@{ @"error":  @{ @"code": @"location_permissions_restricted" } });
+      break;
+    case HTLocationErrorLocationPermissionsReducedAccuracy:
+      resolve(@{ @"error":  @{ @"code": @"location_permissions_reduced_accuracy" } });
+      break;
+    case HTLocationErrorLocationPermissionsDenied:
+      resolve(@{ @"error":  @{ @"code": @"location_permissions_denied" } });
+      break;
+    case HTLocationErrorLocationServicesDisabled:
+      resolve(@{ @"error":  @{ @"code": @"location_services_disabled" } });
+      break;
+    case HTLocationErrorMotionActivityPermissionsNotDetermined:
+      resolve(@{ @"error":  @{ @"code": @"motion_activity_permissions_not_determined" } });
+      break;
+    case HTLocationErrorMotionActivityPermissionsCantBeAskedInBackground:
+      resolve(@{ @"error":  @{ @"code": @"motion_activity_permissions_cant_be_asked_in_background" } });
+      break;
+    case HTLocationErrorMotionActivityPermissionsDenied:
+      resolve(@{ @"error":  @{ @"code": @"motion_activity_permissions_denied" } });
+      break;
+    case HTLocationErrorMotionActivityServicesDisabled:
+      resolve(@{ @"error":  @{ @"code": @"motion_activity_services_disabled" } });
+      break;
+    case HTLocationErrorNotRunning:
+      resolve(@{ @"error":  @{ @"code": @"not_running" } });
+      break;
+    case HTLocationErrorGpsSignalLost:
+      resolve(@{ @"error":  @{ @"code": @"gps_signal_lost" } });
+      break;
+    case HTLocationErrorStarting:
+      resolve(@{ @"error":  @{ @"code": @"starting" } });
+      break;
+    case HTLocationErrorLocationMocked:
+      resolve(@{ @"error":  @{ @"code": @"location_mocked" } });
+      break;
+  }
+}
+
 RCT_EXPORT_METHOD(getDeviceID:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject) {
     resolve(self.hyperTrack.deviceID);
 }

package/ios/RNHyperTrack.xcodeproj/project.xcworkspace/contents.xcworkspacedata

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Workspace
+   version = "1.0">
+   <FileRef
+      location = "self:">
+   </FileRef>
+</Workspace>

package/ios/RNHyperTrack.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>IDEDidComputeMac32BitWarning</key>
+	<true/>
+</dict>
+</plist>

package/ios/RNHyperTrack.xcodeproj/xcuserdata/tulushev.xcuserdatad/xcschemes/xcschememanagement.plist

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>SchemeUserState</key>
+	<dict>
+		<key>RNHyperTrack.xcscheme_^#shared#^_</key>
+		<dict>
+			<key>orderHint</key>
+			<integer>0</integer>
+		</dict>
+	</dict>
+</dict>
+</plist>

package/js/CriticalErrors.js

@@ -45,4 +45,53 @@ export const INVALID_ARGUMENTS = 3;
  * Interface for accessing adding geotag result. 
  * @property {number} code - is one of {@link PLATFORM_NOT_SUPPORTED}, {@link LOCATION_NOT_AVAILABLE}, {@link LOCATION_MISMATCH}, {@link INVALID_ARGUMENTS}
  */
-export type GeotagError = { code: number }
+export type GeotagError = { code: number }
+
+
+
+// The reason for why the SDK doesn't have a fresh location.
+
+// The user has not chosen whether the app can use location services.
+// SDK automatically asked for permissions.
+export const LOCATION_PERMISSIONS_NOT_DETERMINED = "location_permissions_not_determined";
+// The user has not chosen whether the app can use location services.
+// SDK can't ask for permissions in background.
+export const LOCATION_PERMISSIONS_CANT_BE_ASKED_IN_BACKGROUND = "location_permissions_cant_be_asked_in_background";
+// Can't start tracking in background with When In Use location
+// permissions. SDK will automatically start tracking when app will return
+// to foreground.
+export const LOCATION_PERMISSIONS_INSUFFICIENT_FOR_BACKGROUND = "location_permissions_insufficient_for_background";
+// The app is not authorized to use location services.
+export const LOCATION_PERMISSIONS_RESTRICTED = "location_permissions_restricted";
+// The user didn't grant precise location permissions or downgraded permissions to imprecise.
+export const LOCATION_PERMISSIONS_REDUCED_ACCURACY = "location_permissions_reduced_accuracy";
+// The user denied location permissions.
+export const LOCATION_PERMISSIONS_DENIED = "location_permissions_denied";
+// The user disabled location services systemwide.
+export const LOCATION_SERVICES_DISABLED = "location_services_disabled";
+// The user has not chosen whether the app can use motion activity
+// services. SDK automatically asked for permissions.
+export const MOTION_ACTIVITY_PERMISSIONS_NOT_DETERMINED = "motion_activity_permissions_not_determined";
+// The user has not chosen whether the app can use motion activity
+// services. SDK can't ask for permissions in background.
+export const MOTION_ACTIVITY_PERMISSIONS_CANT_BE_ASKED_IN_BACKGROUND = "motion_activity_permissions_cant_be_asked_in_background";
+// Motion activity permissions denied after SDK's initialization. Granting
+// them will restart the app, so in effect, they are denied during this app's
+// session.
+export const MOTION_ACTIVITY_PERMISSIONS_DENIED = "motion_activity_permissions_denied";
+// The user disabled motion services systemwide.
+export const MOTION_ACTIVITY_SERVICES_DISABLED = "motion_activity_services_disabled";
+// The SDK is not collecting locations because it's either not tracking or is unavailable.
+export const NOT_RUNNING = "not_running";
+// GPS satellites are not in view.
+export const GPS_SIGNAL_LOST = "gps_signal_lost";
+// The SDK started collecting locations and is waiting for OS location services to respond.
+export const STARTING = "starting";
+// The user enabled mock location app while mocking locations is prohibited.
+export const LOCATION_MOCKED = "location_mocked";
+
+/** 
+ * Interface for accessing location error value. 
+ * @property {string} code - reason for why location is not available, one of {@link LOCATION_PERMISSIONS_NOT_DETERMINED}, {@link LOCATION_PERMISSIONS_CANT_BE_ASKED_IN_BACKGROUND}, {@link LOCATION_PERMISSIONS_INSUFFICIENT_FOR_BACKGROUND}, {@link LOCATION_PERMISSIONS_RESTRICTED}, {@link LOCATION_PERMISSIONS_REDUCED_ACCURACY}, {@link LOCATION_SERVICES_DISABLED}, {@link MOTION_ACTIVITY_PERMISSIONS_NOT_DETERMINED}, {@link MOTION_ACTIVITY_PERMISSIONS_CANT_BE_ASKED_IN_BACKGROUND}, {@link MOTION_ACTIVITY_PERMISSIONS_DENIED}, {@link MOTION_ACTIVITY_SERVICES_DISABLED}, {@link GPS_SIGNAL_LOST}, {@link STARTING}
+ */
+export type LocationError = { code: string }

package/js/HyperTrack.js

@@ -1,7 +1,7 @@
 'use strict';
 
 import EventEmitter from './EventEmitter';
-import {Error, GeotagError} from './CriticalErrors';
+import {Error, GeotagError, LocationError} from './CriticalErrors';
 
 const HyperTrack = require('react-native').NativeModules.HyperTrack;
 
@@ -43,6 +43,11 @@ class HyperTrackAPI {
         HyperTrack.stopTracking();
     }
 
+    /// The current location of the user or an outage reason.
+    getLocation(): Promise<LocationError|GeolocationCoordinates> {
+        return HyperTrack.getLocation();
+    }
+
     /**
      * Registers tracking state callbacks.
      * @param {Object} component - Instance of your component.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hypertrack-sdk-react-native",
-  "version": "7.14.0",
+  "version": "7.17.0",
   "description": "React Native module for a HyperTrack SDK",
   "main": "./js/index.js",
   "author": "HyperTrack <help@hypertrack.com> (https://hypertrack.com)",