hypertrack-sdk-react-native 9.0.0 → 9.1.0

package/CHANGELOG.md

@@ -3,6 +3,11 @@
 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).
 
+## [9.1.0] - 2023-03-21
+
+### Added
+- `automaticallyRequestPermissions` param to `initialize()`
+
 ## [9.0.0] - 2023-02-17
 
 ### Changed
@@ -23,6 +28,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `subscribeToAvailability()`
 
 ### Removed
+- `automaticallyRequestPermissions` param from `initialize()`
 - `enableDebugLogging()` (use `initialize()` param `loggingEnabled` istead)
 - `setTripMarker()` (use `addGeotag` instead)
 

package/CONTRIBUTING.md

@@ -18,14 +18,12 @@
   
 3. Update CHANGELOG.md
 4. Update badge in README.md
-5. Commit
-5. Create a version tag
-6. Push branch and tags
-7. Create a Github repo release
+5. Do the release dry run with `just release` and verify that the release is correct (checklist is in the command output)
+6. Commit and merge to master
+7. Create and push a new version tag
+8. Run `npm publish` to publish the package to npm
+9. Create a Github repo release
    - Release title should be the current version tag
-8. `yarn release`
-   - will generate docs
-9. `yarn npm publish`
 
 ### How to change build config
 

package/README.md

@@ -13,7 +13,7 @@ For information about how to get started with React Native HyperTrack SDK, pleas
 
 ## Installation
 
-[Install from NPM](https://www.npmjs.com/package/hypertrack-sdk-react-native)
+`yarn add hypertrack-sdk-react-native`
 
 ## Sample code
 

package/android/src/main/java/com/reactnativehypertracksdk/HyperTrackReactNativePlugin.kt

@@ -70,7 +70,7 @@ class HyperTrackReactNativePlugin(reactContext: ReactApplicationContext?) :
         promise: Promise
     ) {
         HyperTrackSdkWrapper
-            .initialize(initParams.toHashMap())
+            .initializeSdk(initParams.toHashMap())
             .mapSuccess { sdk ->
                 initListeners(sdk)
             }
@@ -122,7 +122,7 @@ class HyperTrackReactNativePlugin(reactContext: ReactApplicationContext?) :
 
     @ReactMethod
     fun getDeviceId(promise: Promise) {
-        HyperTrackSdkWrapper.getDeviceID().toPromise(promise)
+        HyperTrackSdkWrapper.getDeviceId().toPromise(promise)
     }
 
     @ReactMethod

package/android/src/main/java/com/reactnativehypertracksdk/common/HyperTrackError.kt

@@ -1,8 +1,9 @@
 package com.reactnativehypertracksdk.common
 
 /**
- * Check HyperTrack SDK docs for HyperTrackError
- * Enum naming convention is ignored to make datatype sync across platforms easier
+ * Check HyperTrack SDK docs for HyperTrackError.
+ * Enum naming convention is ignored to make datatype sync across platforms easier.
+ * Using Swift naming convention.
  */
 @Suppress("EnumEntryName")
 internal enum class HyperTrackError {

package/android/src/main/java/com/reactnativehypertracksdk/common/HyperTrackSdkWrapper.kt

@@ -2,19 +2,16 @@ package com.reactnativehypertracksdk.common
 
 import com.hypertrack.sdk.*
 import com.reactnativehypertracksdk.common.Serialization.deserializeAvailability
+import com.reactnativehypertracksdk.common.Serialization.deserializeDeviceName
 import com.reactnativehypertracksdk.common.Serialization.deserializeGeotagData
-import com.reactnativehypertracksdk.common.Serialization.serializeFailure
+import com.reactnativehypertracksdk.common.Serialization.serializeDeviceId
 import com.reactnativehypertracksdk.common.Serialization.serializeErrors
+import com.reactnativehypertracksdk.common.Serialization.serializeFailure
 import com.reactnativehypertracksdk.common.Serialization.serializeIsAvailable
 import com.reactnativehypertracksdk.common.Serialization.serializeIsTracking
 import com.reactnativehypertracksdk.common.Serialization.serializeSuccess
-import com.reactnativehypertracksdk.common.Serialization.serializeDeviceId
-import com.reactnativehypertracksdk.common.Serialization.deserializeDeviceName
-import com.reactnativehypertracksdk.common.Serialization.parse
 import java.lang.IllegalStateException
 import java.lang.RuntimeException
-import android.util.Log
-
 
 /**
  * This class stores SDK instance, calls HyperTrack SDK methods and serializes responses.
@@ -28,29 +25,32 @@ internal object HyperTrackSdkWrapper {
     val sdkInstance: HyperTrack
         get() = _sdkInstance
 
-    fun initialize(
+    // method is named to align with 'initializeSDK' in iOS
+    fun initializeSdk(
         args: Map<String, Any?>
     ): Result<HyperTrack> {
         return try {
-            SdkInitParams.fromMap(args).flatMapSuccess { initParams ->
-                _sdkInstance = HyperTrack.getInstance(initParams.publishableKey)
-                if (initParams.loggingEnabled) {
-                    HyperTrack.enableDebugLogging()
-                }
-                if (initParams.allowMockLocations) {
-                    sdkInstance.allowMockLocations()
+            SdkInitParams
+                .fromMap(args)
+                .flatMapSuccess { initParams ->
+                    _sdkInstance = HyperTrack.getInstance(initParams.publishableKey)
+                    if (initParams.loggingEnabled) {
+                        HyperTrack.enableDebugLogging()
+                    }
+                    if (initParams.allowMockLocations) {
+                        sdkInstance.allowMockLocations()
+                    }
+                    this.sdkInstance.backgroundTrackingRequirement(
+                        initParams.requireBackgroundTrackingPermission
+                    )
+                    Success(sdkInstance)
                 }
-                this.sdkInstance.backgroundTrackingRequirement(
-                    initParams.requireBackgroundTrackingPermission
-                )
-                Success(sdkInstance)
-            }
         } catch (exception: Exception) {
             Failure(Exception("Hypertrack SDK initialization failed.", exception))
         }
     }
 
-    fun getDeviceID(): Result<Map<String, Any?>> {
+    fun getDeviceId(): Result<Map<String, Any?>> {
         return Success(serializeDeviceId(sdkInstance.deviceID))
     }
 
@@ -70,26 +70,30 @@ internal object HyperTrackSdkWrapper {
     }
 
     fun addGeotag(args: Map<String, Any?>): Result<Map<String, Any?>> {
-        return deserializeGeotagData(args).flatMapSuccess { geotag ->
-            sdkInstance.addGeotag(geotag.data).let { result ->
-                when (result) {
-                    is GeotagResult.SuccessWithDeviation -> {
-                        serializeSuccess(result.deviceLocation)
+        return deserializeGeotagData(args)
+            .flatMapSuccess { geotag ->
+                sdkInstance
+                    .addGeotag(geotag.data)
+                    .let { result ->
+                        when (result) {
+                            is GeotagResult.SuccessWithDeviation -> {
+                                serializeSuccess(result.deviceLocation)
+                            }
+                            is GeotagResult.Success -> {
+                                serializeSuccess(result.deviceLocation)
+                            }
+                            is GeotagResult.Error -> {
+                                serializeFailure(getLocationError(result.reason))
+                            }
+                            else -> {
+                                throw IllegalArgumentException()
+                            }
+                        }
                     }
-                    is GeotagResult.Success -> {
-                        serializeSuccess(result.deviceLocation)
+                    .let {
+                        Success(it)
                     }
-                    is GeotagResult.Error -> {
-                        serializeFailure(getLocationError(result.reason))
-                    }
-                    else -> {
-                        throw IllegalArgumentException()
-                    }
-                }
-            }.let {
-                Success(it)
             }
-        }
     }
 
     fun isTracking(): Result<Map<String, Any?>> {
@@ -103,19 +107,21 @@ internal object HyperTrackSdkWrapper {
     }
 
     fun setAvailability(args: Map<String, Any?>): Result<Unit> {
-        return deserializeAvailability(args).mapSuccess { isAvailable ->
-            if (isAvailable) {
-                sdkInstance.availability = Availability.AVAILABLE
-            } else {
-                sdkInstance.availability = Availability.UNAVAILABLE
+        return deserializeAvailability(args)
+            .mapSuccess { isAvailable ->
+                if (isAvailable) {
+                    sdkInstance.availability = Availability.AVAILABLE
+                } else {
+                    sdkInstance.availability = Availability.UNAVAILABLE
+                }
             }
-        }
     }
 
     fun setName(args: Map<String, Any?>): Result<Unit> {
-        return deserializeDeviceName(args).mapSuccess { name ->
-            sdkInstance.setDeviceName(name)
-        }
+        return deserializeDeviceName(args)
+            .mapSuccess { name ->
+                sdkInstance.setDeviceName(name)
+            }
     }
 
     fun setMetadata(metadata: Map<String, Any?>): Result<Unit> {
@@ -126,13 +132,15 @@ internal object HyperTrackSdkWrapper {
     }
 
     fun getLocation(): Result<Map<String, Any?>> {
-        return sdkInstance.latestLocation.let { result ->
-            if (result.isSuccess) {
-                serializeSuccess(result.value)
-            } else {
-                serializeFailure(getLocationError(result.error))
+        return sdkInstance.latestLocation
+            .let { result ->
+                if (result.isSuccess) {
+                    serializeSuccess(result.value)
+                } else {
+                    serializeFailure(getLocationError(result.error))
+                }
             }
-        }.let { Success(it) }
+            .let { Success(it) }
     }
 
     fun getInitialErrors(): List<Map<String, String>> {
@@ -163,9 +171,10 @@ internal object HyperTrackSdkWrapper {
             else -> {
                 throw RuntimeException("Unknown tracking error")
             }
-        }.let { hyperTrackError ->
-            (hyperTrackError?.let { setOf(it) } ?: setOf()) + getHyperTrackErrorsFromBlockers()
         }
+            .let { hyperTrackError ->
+                (hyperTrackError?.let { setOf(it) } ?: setOf()) + getHyperTrackErrorsFromBlockers()
+            }
     }
 
     private fun getLocationError(error: OutageReason): LocationError {
@@ -239,5 +248,4 @@ internal object HyperTrackSdkWrapper {
             }
             .toSet()
     }
-
 }

package/android/src/main/java/com/reactnativehypertracksdk/common/Result.kt

@@ -1,29 +1,31 @@
 package com.reactnativehypertracksdk.common
 
-internal sealed class Result<S> {
-    fun <T> flatMapSuccess(onSuccess: (S) -> Result<T>): Result<T> {
+internal sealed class Result<SuccessType> {
+    fun <MappedSuccess> flatMapSuccess(
+        onSuccess: (SuccessType) -> Result<MappedSuccess>
+    ): Result<MappedSuccess> {
         return when (this) {
             is Success -> {
                 onSuccess.invoke(this.success)
             }
             is Failure -> {
-                Failure<T>(this.failure)
+                Failure<MappedSuccess>(this.failure)
             }
         }
     }
 
-    fun <T> mapSuccess(onSuccess: (S) -> T): Result<T> {
+    fun <MappedSuccess> mapSuccess(onSuccess: (SuccessType) -> MappedSuccess): Result<MappedSuccess> {
         return when (this) {
             is Success -> {
                 Success(onSuccess.invoke(this.success))
             }
             is Failure -> {
-                Failure<T>(this.failure)
+                Failure<MappedSuccess>(this.failure)
             }
         }
     }
 
-    fun getOrThrow(): S {
+    fun getOrThrow(): SuccessType {
         return when (this) {
             is Success -> this.success
             is Failure -> throw Exception(
@@ -34,7 +36,7 @@ internal sealed class Result<S> {
     }
 
     companion object {
-        fun <T> tryAsResult(block: () -> T): Result<T> {
+        fun <SuccessType> tryAsResult(block: () -> SuccessType): Result<SuccessType> {
             return try {
                 Success(block.invoke())
             } catch (e: Exception) {
@@ -44,5 +46,5 @@ internal sealed class Result<S> {
     }
 }
 
-internal data class Success<S>(val success: S) : Result<S>()
-internal data class Failure<S>(val failure: Throwable) : Result<S>()
+internal data class Success<SuccessType>(val success: SuccessType) : Result<SuccessType>()
+internal data class Failure<SuccessType>(val failure: Throwable) : Result<SuccessType>()

package/android/src/main/java/com/reactnativehypertracksdk/common/SdkInitParams.kt

@@ -1,7 +1,6 @@
 package com.reactnativehypertracksdk.common
 
 import com.reactnativehypertracksdk.common.Serialization.parse
-import android.util.Log
 
 /**
  * SDK config params
@@ -10,24 +9,26 @@ internal data class SdkInitParams(
     val publishableKey: String,
     val requireBackgroundTrackingPermission: Boolean,
     val loggingEnabled: Boolean,
-    val allowMockLocations: Boolean,
+    val allowMockLocations: Boolean
 ) {
 
     companion object {
         fun fromMap(map: Map<String, Any?>): Result<SdkInitParams> {
-            Log.v(javaClass.simpleName, "fromMap 1")
             return parse(map) {
-                Log.v(javaClass.simpleName, "parse 1")
                 SdkInitParams(
-                    publishableKey = it.get<String>(KEY_PUBLISHABLE_KEY).getOrThrow(),
-                    requireBackgroundTrackingPermission = it.get<Boolean>(
-                        KEY_REQUIRE_BACKGROUND_TRACKING_PERMISSION
-                    ).getOrThrow(),
-                    loggingEnabled = it.get<Boolean>(KEY_LOGGING_ENABLED).getOrThrow(),
-                    allowMockLocations = it.get<Boolean>(KEY_ALLOW_MOCK_LOCATIONS).getOrThrow()
+                    publishableKey = it
+                        .get<String>(KEY_PUBLISHABLE_KEY)
+                        .getOrThrow(),
+                    requireBackgroundTrackingPermission = it
+                        .get<Boolean>(KEY_REQUIRE_BACKGROUND_TRACKING_PERMISSION)
+                        .getOrThrow(),
+                    loggingEnabled = it
+                        .get<Boolean>(KEY_LOGGING_ENABLED)
+                        .getOrThrow(),
+                    allowMockLocations = it
+                        .get<Boolean>(KEY_ALLOW_MOCK_LOCATIONS)
+                        .getOrThrow()
                 )
-            }.also {
-                Log.v(javaClass.simpleName, "fromMap $it")
             }
         }
 
@@ -40,7 +41,4 @@ internal data class SdkInitParams(
         private const val KEY_ALLOW_MOCK_LOCATIONS =
             "allowMockLocations"
     }
-
 }
-
-

package/android/src/main/java/com/reactnativehypertracksdk/common/SdkMethod.kt

@@ -2,11 +2,12 @@ package com.reactnativehypertracksdk.common
 
 /**
  * The list of available methods in the SDK API.
- * Enum naming convention is ignored to make datatype sync across platforms easier
+ * Enum naming convention is ignored to make datatype sync across platforms easier.
+ * Using Swift naming convention.
  */
 internal enum class SdkMethod {
     initialize,
-    getDeviceId,
+    getDeviceID,
     getLocation,
     startTracking,
     stopTracking,

package/android/src/main/java/com/reactnativehypertracksdk/common/Serialization.kt

@@ -63,7 +63,8 @@ internal object Serialization {
             is Errors -> {
                 mapOf(
                     KEY_TYPE to TYPE_LOCATION_ERROR_ERRORS,
-                    KEY_VALUE to locationError.errors.map { serializeHypertrackError(it) }
+                    KEY_VALUE to locationError.errors
+                        .map { serializeHypertrackError(it) }
                 )
             }
         }
@@ -86,39 +87,45 @@ internal object Serialization {
     fun deserializeDeviceName(name: Map<String, Any?>): Result<String> {
         return parse(name) {
             it.assertValue<String>(key = KEY_TYPE, value = TYPE_DEVICE_NAME)
-            it.get<String>(KEY_VALUE).getOrThrow()
+            it
+                .get<String>(KEY_VALUE)
+                .getOrThrow()
         }
     }
 
     fun deserializeAvailability(isAvailable: Map<String, Any?>): Result<Boolean> {
         return parse(isAvailable) {
             it.assertValue<String>(key = KEY_TYPE, value = TYPE_AVAILABILITY)
-            it.get<Boolean>(KEY_VALUE).getOrThrow()
+            it
+                .get<Boolean>(KEY_VALUE)
+                .getOrThrow()
         }
     }
 
     fun deserializeGeotagData(map: Map<String, Any?>): Result<Geotag> {
         return parse(map) {
-            val data = it.get<Map<String, Any?>>(KEY_GEOTAG_DATA).getOrThrow()
+            val data = it
+                .get<Map<String, Any?>>(KEY_GEOTAG_DATA)
+                .getOrThrow()
             Geotag(data)
         }
     }
 
     fun <T> parse(
         source: Map<String, Any?>,
-        parseFunction: (ParsingHandle) -> T
+        parseFunction: (Parser) -> T
     ): Result<T> {
-        val handle = ParsingHandle(source);
+        val parser = Parser(source)
         return try {
-            if (handle.exceptions.isEmpty()) {
-                Success(parseFunction.invoke(handle))
+            if (parser.exceptions.isEmpty()) {
+                Success(parseFunction.invoke(parser))
             } else {
-                Failure(ParsingExceptions(source, handle.exceptions))
+                Failure(ParsingExceptions(source, parser.exceptions))
             }
         } catch (e: Exception) {
             Failure(
-                if (handle.exceptions.isNotEmpty()) {
-                    ParsingExceptions(source, handle.exceptions + e)
+                if (parser.exceptions.isNotEmpty()) {
+                    ParsingExceptions(source, parser.exceptions + e)
                 } else {
                     e
                 }
@@ -126,8 +133,8 @@ internal object Serialization {
         }
     }
 
-    internal class ParsingHandle(
-        private val source: Map<String, Any?>,
+    internal class Parser(
+        private val source: Map<String, Any?>
     ) {
         private val _exceptions = mutableListOf<Exception>()
         val exceptions: List<Exception> = _exceptions
@@ -160,9 +167,12 @@ internal object Serialization {
     internal data class ParsingExceptions(
         val source: Any,
         val exceptions: List<Exception>
-    ) : Throwable(exceptions.joinToString("\n").let {
-        "Invalid input:\n\n${source}\n\n${it}"
-    })
+    ) : Throwable(
+        exceptions.joinToString("\n")
+            .let {
+                "Invalid input:\n\n${source}\n\n$it"
+            }
+    )
 
     internal class ParsingException(
         key: String,
@@ -190,7 +200,4 @@ internal object Serialization {
     private const val KEY_LONGITUDE = "longitude"
 
     const val KEY_GEOTAG_DATA = "data"
-
 }
-
-

package/ios/HyperTrackReactNativePlugin.swift

@@ -63,7 +63,7 @@ class HyperTrackReactNativePlugin: RCTEventEmitter {
     ) {
         sendAsPromise(
             hypertrack_sdk_react_native.getDeviceID(),
-            method: .getDeviceId,
+            method: .getDeviceID,
             resolve,
             reject
         )

package/ios/common/HyperTrackSDKWrapper.swift

@@ -12,6 +12,7 @@ enum FailureResult: Error {
 
 var sdkInstance: HyperTrack! // initialize method is guaranteed to be called (by non-native side) prior to any access to the SDK instance
 
+// method is named 'initializeSDK' to avoid conflict with React Native plugin 'initialize' method
 func initializeSDK(
     _ params: Dictionary<String, Any>
 ) -> Result<SuccessResult, FailureResult> {
@@ -20,6 +21,7 @@ func initializeSDK(
         if let publishableKey = publishableKey {
             switch HyperTrack.makeSDK(
                 publishableKey: publishableKey,
+                automaticallyRequestPermissions: sdkInitParams.automaticallyRequestPermissions,
                 mockLocationsAllowed: sdkInitParams.allowMockLocations
             ) {
             case let .success(hyperTrack):
@@ -38,7 +40,7 @@ func initializeSDK(
 }
 
 func getDeviceID() -> Result<SuccessResult, FailureResult> {
-    .success(.dict(serializeDeviceId(sdkInstance.deviceID)))
+    .success(.dict(serializeDeviceID(sdkInstance.deviceID)))
 }
 
 func getLocation() -> Result<SuccessResult, FailureResult> {
@@ -68,9 +70,8 @@ func setAvailability(
 
 func setName(_ args: Dictionary<String, Any>) -> Result<SuccessResult, FailureResult> {
     deserializeDeviceName(args).flatMap({ (name: String) in
-            .success(asVoid(sdkInstance.setDeviceName(name)))
+        .success(asVoid(sdkInstance.setDeviceName(name)))
     })
-    
 }
 
 func setMetadata(_ map: Dictionary<String, Any>) -> Result<SuccessResult, FailureResult> {
@@ -108,6 +109,7 @@ private func mapFatalError(fatalError: HyperTrack.FatalError) -> FailureResult {
         return .fatalError("missingLocationUpdatesBackgroundModeCapability")
     case .developmentError(.runningOnSimulatorUnsupported):
         return .fatalError("runningOnSimulatorUnsupported")
+    // typo is in the HyperTrack SDK itself, no need to fix (it will be deleted in the next major update)
     case .productionError(.locationServicesUnavalible):
         return .error("locationServicesUnavalible")
     case .productionError(.motionActivityServicesUnavalible):

package/ios/common/SDKInitParams.swift

@@ -2,10 +2,12 @@ public struct SDKInitParams {
     let publishableKey: String
     let loggingEnabled: Bool
     let allowMockLocations: Bool
+    let automaticallyRequestPermissions: Bool
     
     init?(_ map: Dictionary<String, Any>) {
         self.publishableKey = (map["publishableKey"] as! String)
         self.loggingEnabled = (map["loggingEnabled"] as! Bool)
         self.allowMockLocations = (map["allowMockLocations"] as! Bool)
+        self.automaticallyRequestPermissions = (map["automaticallyRequestPermissions"] as! Bool)
     }
 }

package/ios/common/SDKMethod.swift

@@ -1,6 +1,6 @@
 enum SDKMethod: String {
     case initialize = "initialize"
-    case getDeviceId = "getDeviceId"
+    case getDeviceID = "getDeviceID"
     case getLocation = "getLocation"
     case startTracking = "startTracking"
     case stopTracking = "stopTracking"

package/ios/common/Serialization.swift

@@ -98,10 +98,10 @@ func serializeErrors(_ errors: Set<HyperTrack.HyperTrackError>) -> Array<Diction
     })
 }
 
-func serializeDeviceId(_ deviceId: String) -> Dictionary<String, Any> {
+func serializeDeviceID(_ deviceID: String) -> Dictionary<String, Any> {
     return [
         keyType: "deviceID",
-        keyValue: deviceId
+        keyValue: deviceID
     ]
 }
 
@@ -143,7 +143,6 @@ func serializeLocationResult(_ result: Result<HyperTrack.Location, HyperTrack.Lo
             locationError = serializeHyperTrackErrorAsLocationError(HyperTrackError.motionActivityPermissionsDenied)
         case .motionActivityServicesDisabled:
             locationError = serializeHyperTrackErrorAsLocationError(HyperTrackError.motionActivityServicesDisabled)
-
         case .gpsSignalLost:
             locationError = serializeHyperTrackErrorAsLocationError(HyperTrackError.gpsSignalLost)
         case .locationMocked:
@@ -157,7 +156,6 @@ func serializeLocationResult(_ result: Result<HyperTrack.Location, HyperTrack.Lo
                 keyType: "notRunning"
             ]
         }
-
         return [
             keyType: typeFailure,
             keyValue: locationError
@@ -195,7 +193,7 @@ func serializeLocationResult(_ result: Result<HyperTrack.Location, HyperTrack.No
                 keyValue: serializeErrors(errors)
             ]
         }
-        
+
         return [
             keyType: typeFailure,
             keyValue: locationError

package/lib/commonjs/HyperTrack/HyperTrack.js

@@ -38,7 +38,8 @@ class HyperTrack {
         publishableKey,
         loggingEnabled: sdkInitParams.loggingEnabled ?? false,
         allowMockLocations: sdkInitParams.allowMockLocations ?? false,
-        requireBackgroundTrackingPermission: sdkInitParams.requireBackgroundTrackingPermission ?? false
+        requireBackgroundTrackingPermission: sdkInitParams.requireBackgroundTrackingPermission ?? false,
+        automaticallyRequestPermissions: sdkInitParams.automaticallyRequestPermissions ?? true
       });
       return new HyperTrack();
     } catch (error) {

package/lib/commonjs/HyperTrack/HyperTrack.js.map

@@ -1 +1 @@
-{"version":3,"names":["EVENT_TRACKING","EVENT_AVAILABILITY","EVENT_ERROR","LINKING_ERROR","Platform","select","ios","default","HyperTrackSdk","NativeModules","HyperTrackReactNativePlugin","Proxy","get","Error","EventEmitter","NativeEventEmitter","HyperTrack","constructor","initialize","publishableKey","sdkInitParams","initializeSdk","loggingEnabled","allowMockLocations","requireBackgroundTrackingPermission","error","message","getDeviceId","then","deviceId","value","isAvailable","setAvailability","type","isTracking","sync","startTracking","stopTracking","getLocation","locationResponse","deserializeLocationResponse","setName","name","setMetadata","data","addGeotag","subscribeToErrors","listener","addListener","rawErrors","deserializeHyperTrackErrors","subscribeToTracking","subscribeToAvailability","errors","map","HyperTrackError","response"],"sources":["HyperTrack.ts"],"sourcesContent":["import { NativeModules, Platform, NativeEventEmitter } from 'react-native';\nimport { HyperTrackError } from './data_types/HyperTrackError';\nimport type { IsAvailable } from './data_types/internal/IsAvailable';\nimport type { IsTracking } from './data_types/internal/IsTracking';\nimport type { LocationResponse } from './data_types/internal/LocationResponse';\nimport type { Location } from './data_types/Location';\nimport type { LocationError } from './data_types/LocationError';\nimport type { SdkInitParams } from './data_types/SdkInitParams';\nimport type { DeviceId } from './data_types/internal/DeviceId';\nimport type { Geotag } from './data_types/internal/Geotag';\nimport type { DeviceName } from './data_types/internal/DeviceName';\nimport type { HyperTrackErrorInternal } from './data_types/internal/HyperTrackErrorInternal';\n\nconst EVENT_TRACKING = 'onTrackingChanged';\nconst EVENT_AVAILABILITY = 'onAvailabilityChanged';\nconst EVENT_ERROR = 'onError';\n\nconst LINKING_ERROR =\n  `The package 'hypertrack-sdk-react-native' doesn't seem to be linked. Make sure: \\n\\n` +\n  Platform.select({ ios: \"- You have run 'pod install'\\n\", default: '' }) +\n  '- You rebuilt the app after installing the package\\n' +\n  '- You are not using Expo managed workflow\\n';\n\nconst HyperTrackSdk = NativeModules.HyperTrackReactNativePlugin\n  ? NativeModules.HyperTrackReactNativePlugin\n  : new Proxy(\n    {},\n    {\n      get() {\n        throw new Error(LINKING_ERROR);\n      },\n    }\n  );\n\nconst EventEmitter = new NativeEventEmitter(HyperTrackSdk);\n\nexport default class HyperTrack {\n  private constructor() {\n    return this;\n  }\n\n  /**\n   * Creates an SDK instance\n   * \n   * @param publishableKey publishable key provided in HyperTrack’s dashboard setup page\n   * @param sdkInitParams\n   * @returns HyperTrack instance\n   */\n  static async initialize(\n    publishableKey: string,\n    sdkInitParams: SdkInitParams = {}\n  ): Promise<HyperTrack> {\n    try {\n      await HyperTrackSdk.initializeSdk({\n        publishableKey,\n        loggingEnabled: sdkInitParams.loggingEnabled ?? false,\n        allowMockLocations: sdkInitParams.allowMockLocations ?? false,\n        requireBackgroundTrackingPermission: sdkInitParams.requireBackgroundTrackingPermission ?? false,\n      });\n      return new HyperTrack();\n    } catch (error: any) {\n      throw new Error(error.message);\n    }\n  }\n\n  /**\n   * Returns a string that is used to uniquely identify the device\n   */\n  getDeviceId(): Promise<string> {\n    return HyperTrackSdk.getDeviceId().then(\n      (deviceId: DeviceId) => deviceId.value\n    );\n  }\n\n  /**\n   * Reflects availability of the device for the Nearby search\n   *\n   * @returns true when is available or false when unavailable\n   */\n  isAvailable(): Promise<boolean> {\n    return HyperTrackSdk.isAvailable().then(\n      (isAvailable: IsAvailable) => isAvailable.value\n    );\n  }\n\n  /**\n   * Sets the availability of the device for the Nearby search\n   *\n   * @param availability true when is available or false when unavailable\n   */\n  setAvailability(isAvailable: boolean) {\n    HyperTrackSdk.setAvailability({\n      type: 'isAvailable',\n      value: isAvailable\n    } as IsAvailable);\n  }\n\n  /**\n   * Reflects the tracking intent for the device\n   * \n   * @return {boolean} Whether the user's movement data is getting tracked or not.\n   */\n  isTracking(): Promise<boolean> {\n    return HyperTrackSdk.isTracking().then(\n      (isTracking: IsTracking) => isTracking.value\n    );\n  }\n\n  /**\n   * Syncs the device state with the HyperTrack servers\n   */\n  sync() {\n    HyperTrackSdk.sync();\n  }\n\n  /**\n   * Expresses an intent to start location tracking for the device\n   */\n  startTracking() {\n    HyperTrackSdk.startTracking();\n  }\n\n  /**\n   * Stops location tracking immediately\n   */\n  stopTracking() {\n    HyperTrackSdk.stopTracking();\n  }\n\n  /**\n   * Reflects the current location of the user or an outage reason\n   */\n  getLocation(): Promise<LocationError | Location> {\n    return HyperTrackSdk.getLocation().then(\n      (locationResponse: LocationResponse) => {\n        return this.deserializeLocationResponse(locationResponse);\n      }\n    );\n  }\n\n  /**\n   * Sets the name for the device\n   * @param {string} name\n   */\n  setName(name: string) {\n    HyperTrackSdk.setName({\n      type: 'deviceName',\n      value: name\n    } as DeviceName)\n  }\n\n  /**\n   * Sets the metadata for the device\n   * @param {Object} data - Metadata JSON\n   */\n  setMetadata(data: Object) {\n    HyperTrackSdk.setMetadata(data);\n  }\n\n  /**\n   * Adds a new geotag\n   * @param {Object} data - Geotad data JSON\n   * @returns current location if success or LocationError if failure\n   */\n  addGeotag(data: Object): Promise<LocationError | Location> {\n    return HyperTrackSdk.addGeotag({\n      data\n    } as Geotag).then(\n      (locationResponse: LocationResponse) => {\n        return this.deserializeLocationResponse(locationResponse);\n      }\n    );\n  }\n\n  /**\n   * Subscribe to tracking errors\n   *\n   * @param listener\n   * @returns EmitterSubscription\n   * @example\n   * ```js\n   * const subscription = HyperTrack.subscribeToErrors(errors => {\n   *   errors.forEach(error => {\n   *     // ... error\n   *   })\n   * })\n   *\n   * // later, to stop listening\n   * subscription.remove()\n   * ```\n   */\n  subscribeToErrors(listener: (errors: HyperTrackError[]) => void) {\n    return EventEmitter.addListener(EVENT_ERROR, (rawErrors: HyperTrackErrorInternal[]) => {\n      listener(this.deserializeHyperTrackErrors(rawErrors))\n    });\n  }\n\n  /**\n   * Subscribe to tracking intent changes\n   *\n   * @param listener\n   * @returns EmitterSubscription\n   * @example\n   * ```js\n   * const subscription = HyperTrack.subscribeToTracking(isTracking => {\n   *   if (isTracking) {\n   *     // ... ready to go\n   *   }\n   * })\n   *\n   * // later, to stop listening\n   * subscription.remove()\n   * ```\n   */\n  subscribeToTracking(listener: (isTracking: boolean) => void) {\n    return EventEmitter.addListener(\n      EVENT_TRACKING,\n      (isTracking: IsTracking) => {\n        listener(isTracking.value);\n      }\n    );\n  }\n\n  /**\n   * Subscribe to availability changes\n   *\n   * @param listener\n   * @returns EmitterSubscription\n   * @example\n   * ```js\n   * const subscription = HyperTrack.subscribeToAvailability(isAvailable => {\n   *   if (isAvailable) {\n   *     // ... ready to go\n   *   }\n   * })\n   *\n   * // later, to stop listening\n   * subscription.remove()\n   * ```\n   */\n  subscribeToAvailability(listener: (isAvailable: boolean) => void) {\n    return EventEmitter.addListener(\n      EVENT_AVAILABILITY,\n      (isAvailable: IsAvailable) => {\n        listener(isAvailable.value);\n      }\n    );\n  }\n\n  /** @ignore */\n  private deserializeHyperTrackErrors(errors: HyperTrackErrorInternal[]): HyperTrackError[] {\n    return errors.map((error: HyperTrackErrorInternal) => HyperTrackError[error.value as keyof typeof HyperTrackError])\n  }\n\n  /** @ignore */\n  private deserializeLocationResponse(response: LocationResponse): Location | LocationError {\n    switch(response.type) {\n      case \"success\":\n        return response.value\n      case \"failure\":\n        switch(response.value.type) {\n          case \"notRunning\":\n          case \"starting\":\n            return response.value\n          case \"errors\":\n            return {\n              type: \"errors\",\n              value: this.deserializeHyperTrackErrors(response.value.value)\n            }\n        }\n    };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"names":["EVENT_TRACKING","EVENT_AVAILABILITY","EVENT_ERROR","LINKING_ERROR","Platform","select","ios","default","HyperTrackSdk","NativeModules","HyperTrackReactNativePlugin","Proxy","get","Error","EventEmitter","NativeEventEmitter","HyperTrack","constructor","initialize","publishableKey","sdkInitParams","initializeSdk","loggingEnabled","allowMockLocations","requireBackgroundTrackingPermission","automaticallyRequestPermissions","error","message","getDeviceId","then","deviceId","value","isAvailable","setAvailability","type","isTracking","sync","startTracking","stopTracking","getLocation","locationResponse","deserializeLocationResponse","setName","name","setMetadata","data","addGeotag","subscribeToErrors","listener","addListener","rawErrors","deserializeHyperTrackErrors","subscribeToTracking","subscribeToAvailability","errors","map","HyperTrackError","response"],"sources":["HyperTrack.ts"],"sourcesContent":["import { NativeModules, Platform, NativeEventEmitter } from 'react-native';\nimport { HyperTrackError } from './data_types/HyperTrackError';\nimport type { IsAvailable } from './data_types/internal/IsAvailable';\nimport type { IsTracking } from './data_types/internal/IsTracking';\nimport type { LocationResponse } from './data_types/internal/LocationResponse';\nimport type { Location } from './data_types/Location';\nimport type { LocationError } from './data_types/LocationError';\nimport type { SdkInitParams } from './data_types/SdkInitParams';\nimport type { DeviceId } from './data_types/internal/DeviceId';\nimport type { Geotag } from './data_types/internal/Geotag';\nimport type { DeviceName } from './data_types/internal/DeviceName';\nimport type { HyperTrackErrorInternal } from './data_types/internal/HyperTrackErrorInternal';\n\nconst EVENT_TRACKING = 'onTrackingChanged';\nconst EVENT_AVAILABILITY = 'onAvailabilityChanged';\nconst EVENT_ERROR = 'onError';\n\nconst LINKING_ERROR =\n  `The package 'hypertrack-sdk-react-native' doesn't seem to be linked. Make sure: \\n\\n` +\n  Platform.select({ ios: \"- You have run 'pod install'\\n\", default: '' }) +\n  '- You rebuilt the app after installing the package\\n' +\n  '- You are not using Expo managed workflow\\n';\n\nconst HyperTrackSdk = NativeModules.HyperTrackReactNativePlugin\n  ? NativeModules.HyperTrackReactNativePlugin\n  : new Proxy(\n    {},\n    {\n      get() {\n        throw new Error(LINKING_ERROR);\n      },\n    }\n  );\n\nconst EventEmitter = new NativeEventEmitter(HyperTrackSdk);\n\nexport default class HyperTrack {\n  private constructor() {\n    return this;\n  }\n\n  /**\n   * Creates an SDK instance\n   * \n   * @param publishableKey publishable key provided in HyperTrack’s dashboard setup page\n   * @param sdkInitParams\n   * @returns HyperTrack instance\n   */\n  static async initialize(\n    publishableKey: string,\n    sdkInitParams: SdkInitParams = {}\n  ): Promise<HyperTrack> {\n    try {\n      await HyperTrackSdk.initializeSdk({\n        publishableKey,\n        loggingEnabled: sdkInitParams.loggingEnabled ?? false,\n        allowMockLocations: sdkInitParams.allowMockLocations ?? false,\n        requireBackgroundTrackingPermission: sdkInitParams.requireBackgroundTrackingPermission ?? false,\n        automaticallyRequestPermissions: sdkInitParams.automaticallyRequestPermissions ?? true,\n      });\n      return new HyperTrack();\n    } catch (error: any) {\n      throw new Error(error.message);\n    }\n  }\n\n  /**\n   * Returns a string that is used to uniquely identify the device\n   */\n  getDeviceId(): Promise<string> {\n    return HyperTrackSdk.getDeviceId().then(\n      (deviceId: DeviceId) => deviceId.value\n    );\n  }\n\n  /**\n   * Reflects availability of the device for the Nearby search\n   *\n   * @returns true when is available or false when unavailable\n   */\n  isAvailable(): Promise<boolean> {\n    return HyperTrackSdk.isAvailable().then(\n      (isAvailable: IsAvailable) => isAvailable.value\n    );\n  }\n\n  /**\n   * Sets the availability of the device for the Nearby search\n   *\n   * @param availability true when is available or false when unavailable\n   */\n  setAvailability(isAvailable: boolean) {\n    HyperTrackSdk.setAvailability({\n      type: 'isAvailable',\n      value: isAvailable\n    } as IsAvailable);\n  }\n\n  /**\n   * Reflects the tracking intent for the device\n   * \n   * @return {boolean} Whether the user's movement data is getting tracked or not.\n   */\n  isTracking(): Promise<boolean> {\n    return HyperTrackSdk.isTracking().then(\n      (isTracking: IsTracking) => isTracking.value\n    );\n  }\n\n  /**\n   * Syncs the device state with the HyperTrack servers\n   */\n  sync() {\n    HyperTrackSdk.sync();\n  }\n\n  /**\n   * Expresses an intent to start location tracking for the device\n   */\n  startTracking() {\n    HyperTrackSdk.startTracking();\n  }\n\n  /**\n   * Stops location tracking immediately\n   */\n  stopTracking() {\n    HyperTrackSdk.stopTracking();\n  }\n\n  /**\n   * Reflects the current location of the user or an outage reason\n   */\n  getLocation(): Promise<LocationError | Location> {\n    return HyperTrackSdk.getLocation().then(\n      (locationResponse: LocationResponse) => {\n        return this.deserializeLocationResponse(locationResponse);\n      }\n    );\n  }\n\n  /**\n   * Sets the name for the device\n   * @param {string} name\n   */\n  setName(name: string) {\n    HyperTrackSdk.setName({\n      type: 'deviceName',\n      value: name\n    } as DeviceName)\n  }\n\n  /**\n   * Sets the metadata for the device\n   * @param {Object} data - Metadata JSON\n   */\n  setMetadata(data: Object) {\n    HyperTrackSdk.setMetadata(data);\n  }\n\n  /**\n   * Adds a new geotag\n   * @param {Object} data - Geotad data JSON\n   * @returns current location if success or LocationError if failure\n   */\n  addGeotag(data: Object): Promise<LocationError | Location> {\n    return HyperTrackSdk.addGeotag({\n      data\n    } as Geotag).then(\n      (locationResponse: LocationResponse) => {\n        return this.deserializeLocationResponse(locationResponse);\n      }\n    );\n  }\n\n  /**\n   * Subscribe to tracking errors\n   *\n   * @param listener\n   * @returns EmitterSubscription\n   * @example\n   * ```js\n   * const subscription = HyperTrack.subscribeToErrors(errors => {\n   *   errors.forEach(error => {\n   *     // ... error\n   *   })\n   * })\n   *\n   * // later, to stop listening\n   * subscription.remove()\n   * ```\n   */\n  subscribeToErrors(listener: (errors: HyperTrackError[]) => void) {\n    return EventEmitter.addListener(EVENT_ERROR, (rawErrors: HyperTrackErrorInternal[]) => {\n      listener(this.deserializeHyperTrackErrors(rawErrors))\n    });\n  }\n\n  /**\n   * Subscribe to tracking intent changes\n   *\n   * @param listener\n   * @returns EmitterSubscription\n   * @example\n   * ```js\n   * const subscription = HyperTrack.subscribeToTracking(isTracking => {\n   *   if (isTracking) {\n   *     // ... ready to go\n   *   }\n   * })\n   *\n   * // later, to stop listening\n   * subscription.remove()\n   * ```\n   */\n  subscribeToTracking(listener: (isTracking: boolean) => void) {\n    return EventEmitter.addListener(\n      EVENT_TRACKING,\n      (isTracking: IsTracking) => {\n        listener(isTracking.value);\n      }\n    );\n  }\n\n  /**\n   * Subscribe to availability changes\n   *\n   * @param listener\n   * @returns EmitterSubscription\n   * @example\n   * ```js\n   * const subscription = HyperTrack.subscribeToAvailability(isAvailable => {\n   *   if (isAvailable) {\n   *     // ... ready to go\n   *   }\n   * })\n   *\n   * // later, to stop listening\n   * subscription.remove()\n   * ```\n   */\n  subscribeToAvailability(listener: (isAvailable: boolean) => void) {\n    return EventEmitter.addListener(\n      EVENT_AVAILABILITY,\n      (isAvailable: IsAvailable) => {\n        listener(isAvailable.value);\n      }\n    );\n  }\n\n  /** @ignore */\n  private deserializeHyperTrackErrors(errors: HyperTrackErrorInternal[]): HyperTrackError[] {\n    return errors.map((error: HyperTrackErrorInternal) => HyperTrackError[error.value as keyof typeof HyperTrackError])\n  }\n\n  /** @ignore */\n  private deserializeLocationResponse(response: LocationResponse): Location | LocationError {\n    switch(response.type) {\n      case \"success\":\n        return response.value\n      case \"failure\":\n        switch(response.value.type) {\n          case \"notRunning\":\n          case \"starting\":\n            return response.value\n          case \"errors\":\n            return {\n              type: \"errors\",\n              value: this.deserializeHyperTrackErrors(response.value.value)\n            }\n        }\n    };\n  }\n}\n"],"mappings":"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"}

package/lib/commonjs/HyperTrack/data_types/SdkInitParams.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sources":["SdkInitParams.ts"],"sourcesContent":["export type SdkInitParams = {\n  loggingEnabled?: boolean;\n  allowMockLocations?: boolean;\n  requireBackgroundTrackingPermission?: boolean;\n};\n"],"mappings":""}
+{"version":3,"names":[],"sources":["SdkInitParams.ts"],"sourcesContent":["/**\n * Parameters for initializing the SDK.\n */\nexport type SdkInitParams = {\n  /**\n   * Enable debug logging.\n   * @default false\n   */\n  loggingEnabled?: boolean;\n\n  /**\n   * Allow mock locations to pass through and don’t send mock location outage.\n   * @default false\n   */\n  allowMockLocations?: boolean;\n\n  /**\n   * Require Background location permissions while requiring permissions on Android.\n   * @default false\n   */\n  requireBackgroundTrackingPermission?: boolean;\n\n  /**\n   * Automatically request permissions on starting tracking on iOS.\n   * @default true\n   */\n  automaticallyRequestPermissions?: boolean;\n};\n"],"mappings":""}

package/lib/module/HyperTrack/HyperTrack.js

@@ -32,7 +32,8 @@ export default class HyperTrack {
         publishableKey,
         loggingEnabled: sdkInitParams.loggingEnabled ?? false,
         allowMockLocations: sdkInitParams.allowMockLocations ?? false,
-        requireBackgroundTrackingPermission: sdkInitParams.requireBackgroundTrackingPermission ?? false
+        requireBackgroundTrackingPermission: sdkInitParams.requireBackgroundTrackingPermission ?? false,
+        automaticallyRequestPermissions: sdkInitParams.automaticallyRequestPermissions ?? true
       });
       return new HyperTrack();
     } catch (error) {

package/lib/module/HyperTrack/HyperTrack.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeModules","Platform","NativeEventEmitter","HyperTrackError","EVENT_TRACKING","EVENT_AVAILABILITY","EVENT_ERROR","LINKING_ERROR","select","ios","default","HyperTrackSdk","HyperTrackReactNativePlugin","Proxy","get","Error","EventEmitter","HyperTrack","constructor","initialize","publishableKey","sdkInitParams","initializeSdk","loggingEnabled","allowMockLocations","requireBackgroundTrackingPermission","error","message","getDeviceId","then","deviceId","value","isAvailable","setAvailability","type","isTracking","sync","startTracking","stopTracking","getLocation","locationResponse","deserializeLocationResponse","setName","name","setMetadata","data","addGeotag","subscribeToErrors","listener","addListener","rawErrors","deserializeHyperTrackErrors","subscribeToTracking","subscribeToAvailability","errors","map","response"],"sources":["HyperTrack.ts"],"sourcesContent":["import { NativeModules, Platform, NativeEventEmitter } from 'react-native';\nimport { HyperTrackError } from './data_types/HyperTrackError';\nimport type { IsAvailable } from './data_types/internal/IsAvailable';\nimport type { IsTracking } from './data_types/internal/IsTracking';\nimport type { LocationResponse } from './data_types/internal/LocationResponse';\nimport type { Location } from './data_types/Location';\nimport type { LocationError } from './data_types/LocationError';\nimport type { SdkInitParams } from './data_types/SdkInitParams';\nimport type { DeviceId } from './data_types/internal/DeviceId';\nimport type { Geotag } from './data_types/internal/Geotag';\nimport type { DeviceName } from './data_types/internal/DeviceName';\nimport type { HyperTrackErrorInternal } from './data_types/internal/HyperTrackErrorInternal';\n\nconst EVENT_TRACKING = 'onTrackingChanged';\nconst EVENT_AVAILABILITY = 'onAvailabilityChanged';\nconst EVENT_ERROR = 'onError';\n\nconst LINKING_ERROR =\n  `The package 'hypertrack-sdk-react-native' doesn't seem to be linked. Make sure: \\n\\n` +\n  Platform.select({ ios: \"- You have run 'pod install'\\n\", default: '' }) +\n  '- You rebuilt the app after installing the package\\n' +\n  '- You are not using Expo managed workflow\\n';\n\nconst HyperTrackSdk = NativeModules.HyperTrackReactNativePlugin\n  ? NativeModules.HyperTrackReactNativePlugin\n  : new Proxy(\n    {},\n    {\n      get() {\n        throw new Error(LINKING_ERROR);\n      },\n    }\n  );\n\nconst EventEmitter = new NativeEventEmitter(HyperTrackSdk);\n\nexport default class HyperTrack {\n  private constructor() {\n    return this;\n  }\n\n  /**\n   * Creates an SDK instance\n   * \n   * @param publishableKey publishable key provided in HyperTrack’s dashboard setup page\n   * @param sdkInitParams\n   * @returns HyperTrack instance\n   */\n  static async initialize(\n    publishableKey: string,\n    sdkInitParams: SdkInitParams = {}\n  ): Promise<HyperTrack> {\n    try {\n      await HyperTrackSdk.initializeSdk({\n        publishableKey,\n        loggingEnabled: sdkInitParams.loggingEnabled ?? false,\n        allowMockLocations: sdkInitParams.allowMockLocations ?? false,\n        requireBackgroundTrackingPermission: sdkInitParams.requireBackgroundTrackingPermission ?? false,\n      });\n      return new HyperTrack();\n    } catch (error: any) {\n      throw new Error(error.message);\n    }\n  }\n\n  /**\n   * Returns a string that is used to uniquely identify the device\n   */\n  getDeviceId(): Promise<string> {\n    return HyperTrackSdk.getDeviceId().then(\n      (deviceId: DeviceId) => deviceId.value\n    );\n  }\n\n  /**\n   * Reflects availability of the device for the Nearby search\n   *\n   * @returns true when is available or false when unavailable\n   */\n  isAvailable(): Promise<boolean> {\n    return HyperTrackSdk.isAvailable().then(\n      (isAvailable: IsAvailable) => isAvailable.value\n    );\n  }\n\n  /**\n   * Sets the availability of the device for the Nearby search\n   *\n   * @param availability true when is available or false when unavailable\n   */\n  setAvailability(isAvailable: boolean) {\n    HyperTrackSdk.setAvailability({\n      type: 'isAvailable',\n      value: isAvailable\n    } as IsAvailable);\n  }\n\n  /**\n   * Reflects the tracking intent for the device\n   * \n   * @return {boolean} Whether the user's movement data is getting tracked or not.\n   */\n  isTracking(): Promise<boolean> {\n    return HyperTrackSdk.isTracking().then(\n      (isTracking: IsTracking) => isTracking.value\n    );\n  }\n\n  /**\n   * Syncs the device state with the HyperTrack servers\n   */\n  sync() {\n    HyperTrackSdk.sync();\n  }\n\n  /**\n   * Expresses an intent to start location tracking for the device\n   */\n  startTracking() {\n    HyperTrackSdk.startTracking();\n  }\n\n  /**\n   * Stops location tracking immediately\n   */\n  stopTracking() {\n    HyperTrackSdk.stopTracking();\n  }\n\n  /**\n   * Reflects the current location of the user or an outage reason\n   */\n  getLocation(): Promise<LocationError | Location> {\n    return HyperTrackSdk.getLocation().then(\n      (locationResponse: LocationResponse) => {\n        return this.deserializeLocationResponse(locationResponse);\n      }\n    );\n  }\n\n  /**\n   * Sets the name for the device\n   * @param {string} name\n   */\n  setName(name: string) {\n    HyperTrackSdk.setName({\n      type: 'deviceName',\n      value: name\n    } as DeviceName)\n  }\n\n  /**\n   * Sets the metadata for the device\n   * @param {Object} data - Metadata JSON\n   */\n  setMetadata(data: Object) {\n    HyperTrackSdk.setMetadata(data);\n  }\n\n  /**\n   * Adds a new geotag\n   * @param {Object} data - Geotad data JSON\n   * @returns current location if success or LocationError if failure\n   */\n  addGeotag(data: Object): Promise<LocationError | Location> {\n    return HyperTrackSdk.addGeotag({\n      data\n    } as Geotag).then(\n      (locationResponse: LocationResponse) => {\n        return this.deserializeLocationResponse(locationResponse);\n      }\n    );\n  }\n\n  /**\n   * Subscribe to tracking errors\n   *\n   * @param listener\n   * @returns EmitterSubscription\n   * @example\n   * ```js\n   * const subscription = HyperTrack.subscribeToErrors(errors => {\n   *   errors.forEach(error => {\n   *     // ... error\n   *   })\n   * })\n   *\n   * // later, to stop listening\n   * subscription.remove()\n   * ```\n   */\n  subscribeToErrors(listener: (errors: HyperTrackError[]) => void) {\n    return EventEmitter.addListener(EVENT_ERROR, (rawErrors: HyperTrackErrorInternal[]) => {\n      listener(this.deserializeHyperTrackErrors(rawErrors))\n    });\n  }\n\n  /**\n   * Subscribe to tracking intent changes\n   *\n   * @param listener\n   * @returns EmitterSubscription\n   * @example\n   * ```js\n   * const subscription = HyperTrack.subscribeToTracking(isTracking => {\n   *   if (isTracking) {\n   *     // ... ready to go\n   *   }\n   * })\n   *\n   * // later, to stop listening\n   * subscription.remove()\n   * ```\n   */\n  subscribeToTracking(listener: (isTracking: boolean) => void) {\n    return EventEmitter.addListener(\n      EVENT_TRACKING,\n      (isTracking: IsTracking) => {\n        listener(isTracking.value);\n      }\n    );\n  }\n\n  /**\n   * Subscribe to availability changes\n   *\n   * @param listener\n   * @returns EmitterSubscription\n   * @example\n   * ```js\n   * const subscription = HyperTrack.subscribeToAvailability(isAvailable => {\n   *   if (isAvailable) {\n   *     // ... ready to go\n   *   }\n   * })\n   *\n   * // later, to stop listening\n   * subscription.remove()\n   * ```\n   */\n  subscribeToAvailability(listener: (isAvailable: boolean) => void) {\n    return EventEmitter.addListener(\n      EVENT_AVAILABILITY,\n      (isAvailable: IsAvailable) => {\n        listener(isAvailable.value);\n      }\n    );\n  }\n\n  /** @ignore */\n  private deserializeHyperTrackErrors(errors: HyperTrackErrorInternal[]): HyperTrackError[] {\n    return errors.map((error: HyperTrackErrorInternal) => HyperTrackError[error.value as keyof typeof HyperTrackError])\n  }\n\n  /** @ignore */\n  private deserializeLocationResponse(response: LocationResponse): Location | LocationError {\n    switch(response.type) {\n      case \"success\":\n        return response.value\n      case \"failure\":\n        switch(response.value.type) {\n          case \"notRunning\":\n          case \"starting\":\n            return response.value\n          case \"errors\":\n            return {\n              type: \"errors\",\n              value: this.deserializeHyperTrackErrors(response.value.value)\n            }\n        }\n    };\n  }\n}\n"],"mappings":"AAAA,SAASA,aAAa,EAAEC,QAAQ,EAAEC,kBAAkB,QAAQ,cAAc;AAC1E,SAASC,eAAe,QAAQ,8BAA8B;AAY9D,MAAMC,cAAc,GAAG,mBAAmB;AAC1C,MAAMC,kBAAkB,GAAG,uBAAuB;AAClD,MAAMC,WAAW,GAAG,SAAS;AAE7B,MAAMC,aAAa,GAChB,sFAAqF,GACtFN,QAAQ,CAACO,MAAM,CAAC;EAAEC,GAAG,EAAE,gCAAgC;EAAEC,OAAO,EAAE;AAAG,CAAC,CAAC,GACvE,sDAAsD,GACtD,6CAA6C;AAE/C,MAAMC,aAAa,GAAGX,aAAa,CAACY,2BAA2B,GAC3DZ,aAAa,CAACY,2BAA2B,GACzC,IAAIC,KAAK,CACT,CAAC,CAAC,EACF;EACEC,GAAG,GAAG;IACJ,MAAM,IAAIC,KAAK,CAACR,aAAa,CAAC;EAChC;AACF,CAAC,CACF;AAEH,MAAMS,YAAY,GAAG,IAAId,kBAAkB,CAACS,aAAa,CAAC;AAE1D,eAAe,MAAMM,UAAU,CAAC;EACtBC,WAAW,GAAG;IACpB,OAAO,IAAI;EACb;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;EACE,aAAaC,UAAU,CACrBC,cAAsB,EAED;IAAA,IADrBC,aAA4B,uEAAG,CAAC,CAAC;IAEjC,IAAI;MACF,MAAMV,aAAa,CAACW,aAAa,CAAC;QAChCF,cAAc;QACdG,cAAc,EAAEF,aAAa,CAACE,cAAc,IAAI,KAAK;QACrDC,kBAAkB,EAAEH,aAAa,CAACG,kBAAkB,IAAI,KAAK;QAC7DC,mCAAmC,EAAEJ,aAAa,CAACI,mCAAmC,IAAI;MAC5F,CAAC,CAAC;MACF,OAAO,IAAIR,UAAU,EAAE;IACzB,CAAC,CAAC,OAAOS,KAAU,EAAE;MACnB,MAAM,IAAIX,KAAK,CAACW,KAAK,CAACC,OAAO,CAAC;IAChC;EACF;;EAEA;AACF;AACA;EACEC,WAAW,GAAoB;IAC7B,OAAOjB,aAAa,CAACiB,WAAW,EAAE,CAACC,IAAI,CACpCC,QAAkB,IAAKA,QAAQ,CAACC,KAAK,CACvC;EACH;;EAEA;AACF;AACA;AACA;AACA;EACEC,WAAW,GAAqB;IAC9B,OAAOrB,aAAa,CAACqB,WAAW,EAAE,CAACH,IAAI,CACpCG,WAAwB,IAAKA,WAAW,CAACD,KAAK,CAChD;EACH;;EAEA;AACF;AACA;AACA;AACA;EACEE,eAAe,CAACD,WAAoB,EAAE;IACpCrB,aAAa,CAACsB,eAAe,CAAC;MAC5BC,IAAI,EAAE,aAAa;MACnBH,KAAK,EAAEC;IACT,CAAC,CAAgB;EACnB;;EAEA;AACF;AACA;AACA;AACA;EACEG,UAAU,GAAqB;IAC7B,OAAOxB,aAAa,CAACwB,UAAU,EAAE,CAACN,IAAI,CACnCM,UAAsB,IAAKA,UAAU,CAACJ,KAAK,CAC7C;EACH;;EAEA;AACF;AACA;EACEK,IAAI,GAAG;IACLzB,aAAa,CAACyB,IAAI,EAAE;EACtB;;EAEA;AACF;AACA;EACEC,aAAa,GAAG;IACd1B,aAAa,CAAC0B,aAAa,EAAE;EAC/B;;EAEA;AACF;AACA;EACEC,YAAY,GAAG;IACb3B,aAAa,CAAC2B,YAAY,EAAE;EAC9B;;EAEA;AACF;AACA;EACEC,WAAW,GAAsC;IAC/C,OAAO5B,aAAa,CAAC4B,WAAW,EAAE,CAACV,IAAI,CACpCW,gBAAkC,IAAK;MACtC,OAAO,IAAI,CAACC,2BAA2B,CAACD,gBAAgB,CAAC;IAC3D,CAAC,CACF;EACH;;EAEA;AACF;AACA;AACA;EACEE,OAAO,CAACC,IAAY,EAAE;IACpBhC,aAAa,CAAC+B,OAAO,CAAC;MACpBR,IAAI,EAAE,YAAY;MAClBH,KAAK,EAAEY;IACT,CAAC,CAAe;EAClB;;EAEA;AACF;AACA;AACA;EACEC,WAAW,CAACC,IAAY,EAAE;IACxBlC,aAAa,CAACiC,WAAW,CAACC,IAAI,CAAC;EACjC;;EAEA;AACF;AACA;AACA;AACA;EACEC,SAAS,CAACD,IAAY,EAAqC;IACzD,OAAOlC,aAAa,CAACmC,SAAS,CAAC;MAC7BD;IACF,CAAC,CAAW,CAAChB,IAAI,CACdW,gBAAkC,IAAK;MACtC,OAAO,IAAI,CAACC,2BAA2B,CAACD,gBAAgB,CAAC;IAC3D,CAAC,CACF;EACH;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEO,iBAAiB,CAACC,QAA6C,EAAE;IAC/D,OAAOhC,YAAY,CAACiC,WAAW,CAAC3C,WAAW,EAAG4C,SAAoC,IAAK;MACrFF,QAAQ,CAAC,IAAI,CAACG,2BAA2B,CAACD,SAAS,CAAC,CAAC;IACvD,CAAC,CAAC;EACJ;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEE,mBAAmB,CAACJ,QAAuC,EAAE;IAC3D,OAAOhC,YAAY,CAACiC,WAAW,CAC7B7C,cAAc,EACb+B,UAAsB,IAAK;MAC1Ba,QAAQ,CAACb,UAAU,CAACJ,KAAK,CAAC;IAC5B,CAAC,CACF;EACH;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEsB,uBAAuB,CAACL,QAAwC,EAAE;IAChE,OAAOhC,YAAY,CAACiC,WAAW,CAC7B5C,kBAAkB,EACjB2B,WAAwB,IAAK;MAC5BgB,QAAQ,CAAChB,WAAW,CAACD,KAAK,CAAC;IAC7B,CAAC,CACF;EACH;;EAEA;EACQoB,2BAA2B,CAACG,MAAiC,EAAqB;IACxF,OAAOA,MAAM,CAACC,GAAG,CAAE7B,KAA8B,IAAKvB,eAAe,CAACuB,KAAK,CAACK,KAAK,CAAiC,CAAC;EACrH;;EAEA;EACQU,2BAA2B,CAACe,QAA0B,EAA4B;IACxF,QAAOA,QAAQ,CAACtB,IAAI;MAClB,KAAK,SAAS;QACZ,OAAOsB,QAAQ,CAACzB,KAAK;MACvB,KAAK,SAAS;QACZ,QAAOyB,QAAQ,CAACzB,KAAK,CAACG,IAAI;UACxB,KAAK,YAAY;UACjB,KAAK,UAAU;YACb,OAAOsB,QAAQ,CAACzB,KAAK;UACvB,KAAK,QAAQ;YACX,OAAO;cACLG,IAAI,EAAE,QAAQ;cACdH,KAAK,EAAE,IAAI,CAACoB,2BAA2B,CAACK,QAAQ,CAACzB,KAAK,CAACA,KAAK;YAC9D,CAAC;QAAA;IACJ;IACJ;EACH;AACF"}
+{"version":3,"names":["NativeModules","Platform","NativeEventEmitter","HyperTrackError","EVENT_TRACKING","EVENT_AVAILABILITY","EVENT_ERROR","LINKING_ERROR","select","ios","default","HyperTrackSdk","HyperTrackReactNativePlugin","Proxy","get","Error","EventEmitter","HyperTrack","constructor","initialize","publishableKey","sdkInitParams","initializeSdk","loggingEnabled","allowMockLocations","requireBackgroundTrackingPermission","automaticallyRequestPermissions","error","message","getDeviceId","then","deviceId","value","isAvailable","setAvailability","type","isTracking","sync","startTracking","stopTracking","getLocation","locationResponse","deserializeLocationResponse","setName","name","setMetadata","data","addGeotag","subscribeToErrors","listener","addListener","rawErrors","deserializeHyperTrackErrors","subscribeToTracking","subscribeToAvailability","errors","map","response"],"sources":["HyperTrack.ts"],"sourcesContent":["import { NativeModules, Platform, NativeEventEmitter } from 'react-native';\nimport { HyperTrackError } from './data_types/HyperTrackError';\nimport type { IsAvailable } from './data_types/internal/IsAvailable';\nimport type { IsTracking } from './data_types/internal/IsTracking';\nimport type { LocationResponse } from './data_types/internal/LocationResponse';\nimport type { Location } from './data_types/Location';\nimport type { LocationError } from './data_types/LocationError';\nimport type { SdkInitParams } from './data_types/SdkInitParams';\nimport type { DeviceId } from './data_types/internal/DeviceId';\nimport type { Geotag } from './data_types/internal/Geotag';\nimport type { DeviceName } from './data_types/internal/DeviceName';\nimport type { HyperTrackErrorInternal } from './data_types/internal/HyperTrackErrorInternal';\n\nconst EVENT_TRACKING = 'onTrackingChanged';\nconst EVENT_AVAILABILITY = 'onAvailabilityChanged';\nconst EVENT_ERROR = 'onError';\n\nconst LINKING_ERROR =\n  `The package 'hypertrack-sdk-react-native' doesn't seem to be linked. Make sure: \\n\\n` +\n  Platform.select({ ios: \"- You have run 'pod install'\\n\", default: '' }) +\n  '- You rebuilt the app after installing the package\\n' +\n  '- You are not using Expo managed workflow\\n';\n\nconst HyperTrackSdk = NativeModules.HyperTrackReactNativePlugin\n  ? NativeModules.HyperTrackReactNativePlugin\n  : new Proxy(\n    {},\n    {\n      get() {\n        throw new Error(LINKING_ERROR);\n      },\n    }\n  );\n\nconst EventEmitter = new NativeEventEmitter(HyperTrackSdk);\n\nexport default class HyperTrack {\n  private constructor() {\n    return this;\n  }\n\n  /**\n   * Creates an SDK instance\n   * \n   * @param publishableKey publishable key provided in HyperTrack’s dashboard setup page\n   * @param sdkInitParams\n   * @returns HyperTrack instance\n   */\n  static async initialize(\n    publishableKey: string,\n    sdkInitParams: SdkInitParams = {}\n  ): Promise<HyperTrack> {\n    try {\n      await HyperTrackSdk.initializeSdk({\n        publishableKey,\n        loggingEnabled: sdkInitParams.loggingEnabled ?? false,\n        allowMockLocations: sdkInitParams.allowMockLocations ?? false,\n        requireBackgroundTrackingPermission: sdkInitParams.requireBackgroundTrackingPermission ?? false,\n        automaticallyRequestPermissions: sdkInitParams.automaticallyRequestPermissions ?? true,\n      });\n      return new HyperTrack();\n    } catch (error: any) {\n      throw new Error(error.message);\n    }\n  }\n\n  /**\n   * Returns a string that is used to uniquely identify the device\n   */\n  getDeviceId(): Promise<string> {\n    return HyperTrackSdk.getDeviceId().then(\n      (deviceId: DeviceId) => deviceId.value\n    );\n  }\n\n  /**\n   * Reflects availability of the device for the Nearby search\n   *\n   * @returns true when is available or false when unavailable\n   */\n  isAvailable(): Promise<boolean> {\n    return HyperTrackSdk.isAvailable().then(\n      (isAvailable: IsAvailable) => isAvailable.value\n    );\n  }\n\n  /**\n   * Sets the availability of the device for the Nearby search\n   *\n   * @param availability true when is available or false when unavailable\n   */\n  setAvailability(isAvailable: boolean) {\n    HyperTrackSdk.setAvailability({\n      type: 'isAvailable',\n      value: isAvailable\n    } as IsAvailable);\n  }\n\n  /**\n   * Reflects the tracking intent for the device\n   * \n   * @return {boolean} Whether the user's movement data is getting tracked or not.\n   */\n  isTracking(): Promise<boolean> {\n    return HyperTrackSdk.isTracking().then(\n      (isTracking: IsTracking) => isTracking.value\n    );\n  }\n\n  /**\n   * Syncs the device state with the HyperTrack servers\n   */\n  sync() {\n    HyperTrackSdk.sync();\n  }\n\n  /**\n   * Expresses an intent to start location tracking for the device\n   */\n  startTracking() {\n    HyperTrackSdk.startTracking();\n  }\n\n  /**\n   * Stops location tracking immediately\n   */\n  stopTracking() {\n    HyperTrackSdk.stopTracking();\n  }\n\n  /**\n   * Reflects the current location of the user or an outage reason\n   */\n  getLocation(): Promise<LocationError | Location> {\n    return HyperTrackSdk.getLocation().then(\n      (locationResponse: LocationResponse) => {\n        return this.deserializeLocationResponse(locationResponse);\n      }\n    );\n  }\n\n  /**\n   * Sets the name for the device\n   * @param {string} name\n   */\n  setName(name: string) {\n    HyperTrackSdk.setName({\n      type: 'deviceName',\n      value: name\n    } as DeviceName)\n  }\n\n  /**\n   * Sets the metadata for the device\n   * @param {Object} data - Metadata JSON\n   */\n  setMetadata(data: Object) {\n    HyperTrackSdk.setMetadata(data);\n  }\n\n  /**\n   * Adds a new geotag\n   * @param {Object} data - Geotad data JSON\n   * @returns current location if success or LocationError if failure\n   */\n  addGeotag(data: Object): Promise<LocationError | Location> {\n    return HyperTrackSdk.addGeotag({\n      data\n    } as Geotag).then(\n      (locationResponse: LocationResponse) => {\n        return this.deserializeLocationResponse(locationResponse);\n      }\n    );\n  }\n\n  /**\n   * Subscribe to tracking errors\n   *\n   * @param listener\n   * @returns EmitterSubscription\n   * @example\n   * ```js\n   * const subscription = HyperTrack.subscribeToErrors(errors => {\n   *   errors.forEach(error => {\n   *     // ... error\n   *   })\n   * })\n   *\n   * // later, to stop listening\n   * subscription.remove()\n   * ```\n   */\n  subscribeToErrors(listener: (errors: HyperTrackError[]) => void) {\n    return EventEmitter.addListener(EVENT_ERROR, (rawErrors: HyperTrackErrorInternal[]) => {\n      listener(this.deserializeHyperTrackErrors(rawErrors))\n    });\n  }\n\n  /**\n   * Subscribe to tracking intent changes\n   *\n   * @param listener\n   * @returns EmitterSubscription\n   * @example\n   * ```js\n   * const subscription = HyperTrack.subscribeToTracking(isTracking => {\n   *   if (isTracking) {\n   *     // ... ready to go\n   *   }\n   * })\n   *\n   * // later, to stop listening\n   * subscription.remove()\n   * ```\n   */\n  subscribeToTracking(listener: (isTracking: boolean) => void) {\n    return EventEmitter.addListener(\n      EVENT_TRACKING,\n      (isTracking: IsTracking) => {\n        listener(isTracking.value);\n      }\n    );\n  }\n\n  /**\n   * Subscribe to availability changes\n   *\n   * @param listener\n   * @returns EmitterSubscription\n   * @example\n   * ```js\n   * const subscription = HyperTrack.subscribeToAvailability(isAvailable => {\n   *   if (isAvailable) {\n   *     // ... ready to go\n   *   }\n   * })\n   *\n   * // later, to stop listening\n   * subscription.remove()\n   * ```\n   */\n  subscribeToAvailability(listener: (isAvailable: boolean) => void) {\n    return EventEmitter.addListener(\n      EVENT_AVAILABILITY,\n      (isAvailable: IsAvailable) => {\n        listener(isAvailable.value);\n      }\n    );\n  }\n\n  /** @ignore */\n  private deserializeHyperTrackErrors(errors: HyperTrackErrorInternal[]): HyperTrackError[] {\n    return errors.map((error: HyperTrackErrorInternal) => HyperTrackError[error.value as keyof typeof HyperTrackError])\n  }\n\n  /** @ignore */\n  private deserializeLocationResponse(response: LocationResponse): Location | LocationError {\n    switch(response.type) {\n      case \"success\":\n        return response.value\n      case \"failure\":\n        switch(response.value.type) {\n          case \"notRunning\":\n          case \"starting\":\n            return response.value\n          case \"errors\":\n            return {\n              type: \"errors\",\n              value: this.deserializeHyperTrackErrors(response.value.value)\n            }\n        }\n    };\n  }\n}\n"],"mappings":"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"}

package/lib/module/HyperTrack/data_types/SdkInitParams.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sources":["SdkInitParams.ts"],"sourcesContent":["export type SdkInitParams = {\n  loggingEnabled?: boolean;\n  allowMockLocations?: boolean;\n  requireBackgroundTrackingPermission?: boolean;\n};\n"],"mappings":""}
+{"version":3,"names":[],"sources":["SdkInitParams.ts"],"sourcesContent":["/**\n * Parameters for initializing the SDK.\n */\nexport type SdkInitParams = {\n  /**\n   * Enable debug logging.\n   * @default false\n   */\n  loggingEnabled?: boolean;\n\n  /**\n   * Allow mock locations to pass through and don’t send mock location outage.\n   * @default false\n   */\n  allowMockLocations?: boolean;\n\n  /**\n   * Require Background location permissions while requiring permissions on Android.\n   * @default false\n   */\n  requireBackgroundTrackingPermission?: boolean;\n\n  /**\n   * Automatically request permissions on starting tracking on iOS.\n   * @default true\n   */\n  automaticallyRequestPermissions?: boolean;\n};\n"],"mappings":""}

package/lib/typescript/HyperTrack/data_types/SdkInitParams.d.ts

@@ -1,5 +1,25 @@
+/**
+ * Parameters for initializing the SDK.
+ */
 export type SdkInitParams = {
+    /**
+     * Enable debug logging.
+     * @default false
+     */
     loggingEnabled?: boolean;
+    /**
+     * Allow mock locations to pass through and don’t send mock location outage.
+     * @default false
+     */
     allowMockLocations?: boolean;
+    /**
+     * Require Background location permissions while requiring permissions on Android.
+     * @default false
+     */
     requireBackgroundTrackingPermission?: boolean;
+    /**
+     * Automatically request permissions on starting tracking on iOS.
+     * @default true
+     */
+    automaticallyRequestPermissions?: boolean;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "hypertrack-sdk-react-native",
-    "version": "9.0.0",
+    "version": "9.1.0",
     "description": "React Native HyperTrack SDK is a wrapper around native iOS and Android SDKs that allows to integrate HyperTrack into React Native apps.",
     "main": "lib/commonjs/index",
     "module": "lib/module/index",

package/src/HyperTrack/HyperTrack.ts

@@ -56,6 +56,7 @@ export default class HyperTrack {
         loggingEnabled: sdkInitParams.loggingEnabled ?? false,
         allowMockLocations: sdkInitParams.allowMockLocations ?? false,
         requireBackgroundTrackingPermission: sdkInitParams.requireBackgroundTrackingPermission ?? false,
+        automaticallyRequestPermissions: sdkInitParams.automaticallyRequestPermissions ?? true,
       });
       return new HyperTrack();
     } catch (error: any) {

package/src/HyperTrack/data_types/SdkInitParams.ts

@@ -1,5 +1,28 @@
+/**
+ * Parameters for initializing the SDK.
+ */
 export type SdkInitParams = {
+  /**
+   * Enable debug logging.
+   * @default false
+   */
   loggingEnabled?: boolean;
+
+  /**
+   * Allow mock locations to pass through and don’t send mock location outage.
+   * @default false
+   */
   allowMockLocations?: boolean;
+
+  /**
+   * Require Background location permissions while requiring permissions on Android.
+   * @default false
+   */
   requireBackgroundTrackingPermission?: boolean;
+
+  /**
+   * Automatically request permissions on starting tracking on iOS.
+   * @default true
+   */
+  automaticallyRequestPermissions?: boolean;
 };