@sentiance-react-native/core 6.8.0-alpha.1 → 6.8.0-beta.1

package/RNSentianceCore.podspec

@@ -5,7 +5,7 @@ sentiance_sdk_env_var_version = ENV["SENTIANCE_RN_IOS_SDK_VERSION"]
 
 Pod::Spec.new do |s|
   s.name         = "RNSentianceCore"
-  s.version      = "6.8.0-alpha.1"
+  s.version      = "6.8.0-beta.1"
   s.summary      = "RNSentianceCore"
   s.description  = <<-DESC
                    RNSentianceCore

package/android/src/main/java/com/sentiance/react/bridge/core/common/base/AbstractSentianceModule.java

@@ -44,8 +44,26 @@ public abstract class AbstractSentianceModule extends ReactContextBaseJavaModule
 
   }
 
+  /**
+   * This binding is invoked when the Sentiance SDK's Javascript APIs attempt to unregister listeners for a specific event.
+   *
+   * @param eventName the name of the event from which the app wants to unsubscribe.
+   * @param subscriptionId The identifier of the Javascript subscription that was created following
+   *                       an attempt to add a listener for the provided event name.
+   * @param promise that resolves once the native SDK listener(s) has/have been unset.
+   */
   protected abstract void removeNativeListener(String eventName, int subscriptionId, Promise promise);
 
+  /**
+   * This binding is invoked when the Sentiance SDK's Javascript APIs attempt to register listeners for a specific event.
+   *
+   * @param eventName the name of the event of which the app wants to be notified.
+   * @param subscriptionId The identifier of the Javascript subscription that was created following
+   *                       an attempt to add a listener for the provided event name. By default,
+   *                       React Native supports adding multiple listeners for the same event,
+   *                       but most of the Sentiance native SDKs don't.
+   * @param promise that resolves once the native SDK listener(s) has/have been set.
+   */
   protected abstract void addNativeListener(String eventName, int subscriptionId, Promise promise);
 
   protected abstract void addListener(String eventName);

package/ios/RNSentianceCore+Converter.h

@@ -55,5 +55,8 @@ typedef NS_ENUM(NSInteger, UIBackgroundRefreshStatus);
 - (NSArray *)convertCallWhileMovingEvents:(NSArray<SENTCallWhileMovingEvent*> *)callWhileMovingEvents;
 - (NSArray *)convertSpeedingEvents:(NSArray<SENTSpeedingEvent*> *)speedingEvents;
 - (NSMutableDictionary*)convertEvent:(SENTTimelineEvent*)event;
+- (NSError *)convertSmartGeofencesRefreshError:(SENTSmartGeofencesRefreshError *)refreshError;
+- (NSString *)stringifySmartGeofencesDetectionMode:(SENTSmartGeofenceDetectionMode)detectionMode;
+- (NSDictionary*)convertSmartGeofenceEvent:(SENTSmartGeofenceEvent*)event;
 
 @end

package/ios/RNSentianceCore+Converter.m

@@ -10,6 +10,9 @@
 @import UIKit.UIApplication;
 @import CoreLocation;
 
+static NSString * const SmartGeofencesErrorDomain = @"com.sentiance.SmartGeofencesModule";
+
+
 @interface RNSentianceCore (Private)
 
 - (NSString*)convertTimelineEventTypeToString:(SENTTimelineEventType)type;
@@ -464,14 +467,14 @@
 
 - (NSArray*)convertSegmentAttributes:(NSArray<SENTAttribute *>*)attributes {
     NSMutableArray *attributeArray = [[NSMutableArray alloc] init];
-    
+
     for (SENTAttribute* attribute in attributes) {
         NSMutableDictionary *attributeDict = [[NSMutableDictionary alloc] init];
         attributeDict[@"name"] = attribute.name;
         attributeDict[@"value"] = @(attribute.value);
         [attributeArray addObject:attributeDict];
     }
-    
+
     return attributeArray;
 }
 
@@ -1243,4 +1246,97 @@
     return dict;
 }
 
+- (NSError *)convertSmartGeofencesRefreshError:(SENTSmartGeofencesRefreshError *)refreshError {
+    NSString *reason;
+    NSString *details = refreshError.details == nil ? @"": refreshError.details;
+
+    switch (refreshError.failureReason) {
+        case SENTSmartGeofencesRefreshFailureReasonNetworkUsageRestricted:
+            reason = @"NETWORK_USAGE_RESTRICTED";
+            break;
+        case SENTSmartGeofencesRefreshFailureReasonNetworkError:
+            reason = @"NETWORK_ERROR";
+            break;
+        case SENTSmartGeofencesRefreshFailureReasonServerError:
+            reason = @"SERVER_ERROR";
+            break;
+        case SENTSmartGeofencesRefreshFailureReasonTooManyFrequentCalls:
+            reason = @"TOO_MANY_FREQUENT_CALLS";
+            break;
+        case SENTSmartGeofencesRefreshFailureReasonFeatureNotEnabled:
+            reason = @"FEATURE_NOT_ENABLED";
+            break;
+        case SENTSmartGeofencesRefreshFailureReasonUnexpectedError:
+        default:
+            reason = @"UNEXPECTED_ERROR";
+            break;
+    }
+
+    NSMutableDictionary *errorInfo = [NSMutableDictionary dictionary];
+    errorInfo[@"reason"] = reason;
+    errorInfo[@"details"] = details;
+
+    NSError *error = [NSError errorWithDomain:SmartGeofencesErrorDomain
+                                         code:0
+                                         userInfo:errorInfo];
+
+    return error;
+}
+
+- (NSString *)stringifySmartGeofencesDetectionMode:(SENTSmartGeofenceDetectionMode)detectionMode {
+    switch (detectionMode) {
+        case SENTSmartGeofenceDetectionModeBackground:
+            return @"BACKGROUND";
+        case SENTSmartGeofenceDetectionModeForeground:
+            return @"FOREGROUND";
+        case SENTSmartGeofenceDetectionModeDisabled:
+            return @"DISABLED";
+        case SENTSmartGeofenceDetectionModeFeatureNotEnabled:
+        default:
+            return @"FEATURE_NOT_ENABLED";
+    }
+}
+
+- (NSDictionary*)convertSmartGeofenceEvent:(SENTSmartGeofenceEvent*)event {
+    NSMutableDictionary* dict = [[NSMutableDictionary alloc] init];
+
+    dict[@"timestamp"] = @((long) ([event.eventDate timeIntervalSince1970] * 1000));
+    dict[@"triggeringLocation"] = [self convertCllocation:event.triggeringLocation];
+
+    NSString *eventType;
+    switch(event.eventType) {
+        case SENTSmartGeofenceEventTypeEntry:
+            eventType = @"ENTRY";
+            break;
+        case SENTSmartGeofenceEventTypeExit:
+            eventType = @"EXIT";
+            break;
+    }
+
+    dict[@"eventType"] = eventType;
+    dict[@"geofences"] = [self convertSmartGeofences:event.geofences];
+
+    return dict;
+}
+
+- (NSArray<NSDictionary<NSString *, NSNumber *> *> *)convertSmartGeofences:(NSArray<SENTSmartGeofence*> *)smartGeofences {
+    NSMutableArray <NSDictionary*> *array = [[NSMutableArray alloc] init];
+    for (SENTSmartGeofence *smartGeofence in smartGeofences) {
+        [array addObject:[self convertSmartGeofence:smartGeofence]];
+    }
+    return array;
+}
+
+- (NSDictionary*)convertSmartGeofence:(SENTSmartGeofence*)smartGeofence {
+    NSMutableDictionary* dict = [[NSMutableDictionary alloc] init];
+
+    dict[@"sentianceId"] = smartGeofence.sentianceId;
+    dict[@"latitude"] = @(smartGeofence.latitude);
+    dict[@"longitude"] = @(smartGeofence.longitude);
+    dict[@"radius"] = @(smartGeofence.radius);
+    dict[@"externalId"] = smartGeofence.externalId;
+
+    return dict;
+}
+
 @end

package/ios/RNSentianceCore.h

@@ -14,8 +14,9 @@ static NSString * _Nonnull const VehicleCrashDiagnosticEvent = @"SENTIANCE_VEHIC
 static NSString * _Nonnull const UserContextUpdateEvent = @"SENTIANCE_USER_CONTEXT_UPDATE_EVENT";
 static NSString * _Nonnull const DrivingInsightsReadyEvent = @"SENTIANCE_DRIVING_INSIGHTS_READY_EVENT";
 static NSString * _Nonnull const TimelineUpdateEvent = @"SENTIANCE_TIMELINE_UPDATE_EVENT";
+static NSString * _Nonnull const SmartGeofenceEvent = @"SENTIANCE_SMART_GEOFENCE_EVENT";
 
-@interface RNSentianceCore : RCTEventEmitter <RCTBridgeModule, SENTUserContextDelegate, SENTDrivingInsightsReadyDelegate, SENTEventTimelineDelegate>
+@interface RNSentianceCore : RCTEventEmitter <RCTBridgeModule, SENTUserContextDelegate, SENTDrivingInsightsReadyDelegate, SENTEventTimelineDelegate, SENTSmartGeofenceEventDelegate>
 typedef void (^SdkStatusHandler)(SENTSDKStatus * _Nonnull status);
 - (SENTUserLinker _Nonnull ) getUserLinker;
 - (SdkStatusHandler _Nonnull) getSdkStatusUpdateHandler;

package/ios/RNSentianceCore.m

@@ -35,7 +35,7 @@ RCT_EXPORT_MODULE(SentianceCore)
 
 - (NSArray<NSString *> *)supportedEvents
 {
-    return @[SdkStatusUpdateEvent, TripTimeoutEvent, UserLinkEvent, UserActivityUpdateEvent, VehicleCrashEvent, VehicleCrashDiagnosticEvent, UserLinkEvent, UserContextUpdateEvent, DrivingInsightsReadyEvent, TimelineUpdateEvent];
+    return @[SdkStatusUpdateEvent, TripTimeoutEvent, UserLinkEvent, UserActivityUpdateEvent, VehicleCrashEvent, VehicleCrashDiagnosticEvent, UserLinkEvent, UserContextUpdateEvent, DrivingInsightsReadyEvent, TimelineUpdateEvent, SmartGeofenceEvent];
 }
 
 // Will be called when this module's first listener is added.
@@ -62,6 +62,10 @@ RCT_EXPORT_MODULE(SentianceCore)
     [self sendEventWithName:TimelineUpdateEvent body:[self convertEvent:event]];
 }
 
+- (void)onSmartGeofenceEvent:(SENTSmartGeofenceEvent * _Nonnull)smartGeofenceEvent {
+    [self sendEventWithName:SmartGeofenceEvent body:[self convertSmartGeofenceEvent:smartGeofenceEvent]];
+}
+
 - (instancetype)init
 {
     self = [super init];
@@ -80,6 +84,12 @@ RCT_EXPORT_MODULE(SentianceCore)
         [[Sentiance sharedInstance] setEventTimelineDelegate:nil];
     } subscriptionType:SENTSubscriptionTypeSingle];
 
+    [_subscriptionsManager addSupportedSubscriptionForEventType:SmartGeofenceEvent nativeSubscribeLogic:^{
+        [[Sentiance sharedInstance] setSmartGeofenceEventsDelegate:weakSelf];
+    } nativeUnsubscribeLogic:^{
+        [[Sentiance sharedInstance] setSmartGeofenceEventsDelegate:nil];
+    } subscriptionType:SENTSubscriptionTypeSingle];
+
     return self;
 }
 
@@ -1161,6 +1171,33 @@ RCT_EXPORT_METHOD(isAllowedToUseMobileData:(RCTPromiseResolveBlock)resolve rejec
     resolve(@(Sentiance.sharedInstance.isAllowedToUseMobileData));
 }
 
+RCT_EXPORT_METHOD(refreshGeofences:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject) {
+    REJECT_IF_SDK_NOT_INITIALIZED(reject);
+
+    @try {
+        [[Sentiance sharedInstance] refreshSmartGeofencesWithCompletionHandler:^(SENTSmartGeofencesRefreshResult * _Nullable result, SENTSmartGeofencesRefreshError * _Nullable error) {
+            if (error != nil) {
+                reject(ESDKSmartGeofencesRefreshError, @"Failed to refresh smart geofences", [self convertSmartGeofencesRefreshError:error]);
+            }
+            else {
+                resolve(nil);
+            }
+        }];
+    } @catch (NSException *e) {
+        reject(e.name, e.reason, nil);
+    }
+}
+
+RCT_EXPORT_METHOD(getDetectionMode:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject) {
+    REJECT_IF_SDK_NOT_INITIALIZED(reject);
+
+    @try {
+        resolve([self stringifySmartGeofencesDetectionMode:Sentiance.sharedInstance.smartGeofenceDetectionMode]);
+    } @catch (NSException *e) {
+        reject(e.name, e.reason, nil);
+    }
+}
+
 - (void)didUpdateUserContext:(SENTUserContext *)userContext
              forCriteriaMask:(SENTUserContextUpdateCriteria)criteriaMask {
     NSDictionary *dict = @{

package/ios/RNSentianceErrorCodes.h

@@ -18,3 +18,4 @@ extern NSString * const ESDKUserLinkAuthCodeError;
 extern NSString * const ESDKCreateUserError;
 extern NSString * const ESDKResetError;
 extern NSString * const ESDKRequestUserContextError;
+extern NSString * const ESDKSmartGeofencesRefreshError;

package/ios/RNSentianceErrorCodes.m

@@ -20,3 +20,4 @@ NSString * const ESDKUserLinkAuthCodeError = @"E_SDK_USER_LINK_AUTH_CODE_ERROR";
 NSString * const ESDKCreateUserError = @"E_SDK_CREATE_USER_ERROR";
 NSString * const ESDKResetError = @"E_SDK_RESET_ERROR";
 NSString * const ESDKRequestUserContextError = @"E_SDK_REQUEST_USER_CONTEXT_ERROR";
+NSString * const ESDKSmartGeofencesRefreshError = @"E_SDK_SMART_GEOFENCES_REFRESH_ERROR";

package/lib/index.d.ts

@@ -61,6 +61,7 @@ declare module "@sentiance-react-native/core" {
   }
 
   export interface Location {
+    timestamp?: number; // marked optional to maintain compatibility, but is always present
     latitude: number;
     longitude: number;
     accuracy?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentiance-react-native/core",
-  "version": "6.8.0-alpha.1",
+  "version": "6.8.0-beta.1",
   "description": "The Sentiance Core library",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
@@ -29,10 +29,10 @@
       "targetSdk": 31,
       "compileSdk": 31,
       "buildTools": "30.0.3",
-      "sentiance": "6.8.0-alpha3"
+      "sentiance": "6.8.0-beta1"
     },
     "ios": {
-      "sentiance": "6.8.0-alpha1"
+      "sentiance": "6.8.0-beta1"
     }
   }
 }