react-native-background-geolocation 5.0.0-beta.4 → 5.0.1

package/.github/ISSUE_TEMPLATE/1-bug.yml

@@ -11,7 +11,7 @@ body:
     id: terms
     attributes:
       label: Required Reading
-      description: "- I have read the Wikis [Philosophy of Operation](../wiki/Philosophy-of-Operation) and [Debugging](../wiki/Debugging)\n- I am aware of the [API Documentation](https://transistorsoft.github.io/react-native-background-geolocation/)\n- I am aware of the [CHANGELOG](../blob/master/CHANGELOG.md)"
+      description: "- I have read the Wikis [Philosophy of Operation](./wiki/Philosophy-of-Operation) and [Debugging](./wiki/Debugging)\n- I am aware of the [API Documentation](https://transistorsoft.github.io/react-native-background-geolocation/)\n- I am aware of the [CHANGELOG](./blob/master/CHANGELOG.md)"
       options:
         - label: Confirmed
           required: true

package/.github/ISSUE_TEMPLATE/2-help-wanted.yml

@@ -11,7 +11,7 @@ body:
     id: terms
     attributes:
       label: Required Reading
-      description: "- I have read the Wikis [Philosophy of Operation](../wiki/Philosophy-of-Operation) and [Debugging](../wiki/Debugging)\n- I am aware of the [API Documentation](https://transistorsoft.github.io/react-native-background-geolocation/)\n- I am aware of the [CHANGELOG](../blob/master/CHANGELOG.md)"
+      description: "- I have read the Wikis [Philosophy of Operation](./wiki/Philosophy-of-Operation) and [Debugging](./wiki/Debugging)\n- I am aware of the [API Documentation](https://transistorsoft.github.io/react-native-background-geolocation/)\n- I am aware of the [CHANGELOG](./blob/master/CHANGELOG.md)"
       options:
         - label: Confirmed
           required: true

package/README.md

@@ -1,6 +1,7 @@
 | <img src="https://dl.dropbox.com/s/gxl3sr8znhkrtah/expo-logo.png?dl=1" alt="alt text" width="32" /> | Now with *Expo* support |
 | --- | --- |
 
+
 Background Geolocation for React Native &middot; [![npm](https://img.shields.io/npm/dm/react-native-background-geolocation.svg)]() [![npm](https://img.shields.io/npm/v/react-native-background-geolocation.svg)]()
 ============================================================================
 
@@ -16,7 +17,7 @@ The plugin's [Philosophy of Operation](../../wiki/Philosophy-of-Operation) is to
 
 - When the device is detected be **stationary**, the plugin will automatically turn off location-services to conserve energy.
 
-Also available for [Flutter](https://github.com/transistorsoft/flutter_background_geolocation), [Cordova](https://github.com/transistorsoft/cordova-background-geolocation-lt), [NativeScript](https://github.com/transistorsoft/nativescript-background-geolocation-lt) and pure native apps.
+Also available for [Flutter](https://github.com/transistorsoft/flutter_background_geolocation), [Cordova](https://github.com/transistorsoft/cordova-background-geolocation-lt), [Capacitor](https://github.com/transistorsoft/capacitor-background-geolocation) and pure native apps.
 
 > [!NOTE]
 > The **[Android module](http://www.transistorsoft.com/shop/products/react-native-background-geolocation)** requires [purchasing a license](http://www.transistorsoft.com/shop/products/react-native-background-geolocation).  However, it *will* work for **DEBUG** builds.  It will **not** work with **RELEASE** builds [without purchasing a license](http://www.transistorsoft.com/shop/products/react-native-background-geolocation).  This plugin is supported **full-time** and field-tested **daily** since 2013.
@@ -28,9 +29,12 @@ Also available for [Flutter](https://github.com/transistorsoft/flutter_backgroun
 ![Home](https://dl.dropboxusercontent.com/s/wa43w1n3xhkjn0i/home-framed-350.png?dl=1)
 ![Settings](https://dl.dropboxusercontent.com/s/8oad228siog49kt/settings-framed-350.png?dl=1)
 
+> [!CAUTION]
+> This README references the new  __`v5.x`__ branch of the SDK.  If you're using __`v4.x`__, you must reference [__`v4.x`__](https://github.com/transistorsoft/react-native-background-geolocation/tree/4.19.4) branch.
+
 # Contents
 - ### 😫 [Help!](../../wiki/Help)
-- ### :books: [API Documentation](https://transistorsoft.github.io/react-native-background-geolocation/5.0.0-beta)
+- ### :books: [API Documentation](https://transistorsoft.github.io/react-native-background-geolocation/latest)
 - ### [Installing the Plugin](#large_blue_diamond-installing-the-plugin)
 - ### [Setup Guides](#large_blue_diamond-setup-guides)
 - ### [Configure your License](#large_blue_diamond-configure-your-license)
@@ -43,22 +47,25 @@ Also available for [Flutter](https://github.com/transistorsoft/flutter_backgroun
 
 ## :large_blue_diamond: Installing the Plugin
 
+> [!CAUTION]
+> This is the new v5 version.  For previous version, see [`v4.x`](https://github.com/transistorsoft/react-native-background-geolocation/tree/4.19.4).  __`v4.x`__ license keys do not work with __`v5`__.  Login to the customer dashboard to generate a __`v5`__ key.
+
 
 ### With *Expo*
 
 ```shell
-npx expo install react-native-background-geolocation@beta
+npx expo install react-native-background-geolocation
 ```
 
 ### With `yarn`
 
 ```bash
-yarn add react-native-background-geolocation@beta
+yarn add react-native-background-geolocation
 ```
 
 ### With `npm`
 ```
-$ npm install react-native-background-geolocation@beta --save
+$ npm install react-native-background-geolocation --save
 ```
 
 ## :large_blue_diamond: Setup Guides
@@ -79,7 +86,7 @@ $ npm install react-native-background-geolocation@beta --save
 [www.transistorsoft.com/shop/customers](http://www.transistorsoft.com/shop/customers)
 ![](https://gallery.mailchimp.com/e932ea68a1cb31b9ce2608656/images/b2696718-a77e-4f50-96a8-0b61d8019bac.png)
 
-2. Add your license-key to `android/app/src/main/AndroidManifest.xml`:
+2. __`[Android]`__ Add your license-key to `android/app/src/main/AndroidManifest.xml`:
 
 ```diff
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
@@ -93,7 +100,7 @@ $ npm install react-native-background-geolocation@beta --save
     android:theme="@style/AppTheme">
 
     <!-- react-native-background-geolocation licence -->
-+     <meta-data android:name="com.transistorsoft.locationmanager.license" android:value="YOUR_LICENCE_KEY_HERE" />
++     <meta-data android:name="com.transistorsoft.locationmanager.license" android:value="YOUR_ANDROID_LICENCE_KEY_HERE" />
     .
     .
     .
@@ -101,36 +108,20 @@ $ npm install react-native-background-geolocation@beta --save
 </manifest>
 ```
 
-## :large_blue_diamond: Using the plugin ##
+3. __`[iOS]`__ Add your license-key to your __`Info.plist`__
 
-```javascript
-import BackgroundGeolocation from "react-native-background-geolocation";
-```
+|      Key     |     Type     |     Value     |
+|-----|-------|-------------|
+| *`TSLocationManagerLicense`* | `String` | `                    <PASTE YOUR IOS LICENSE KEY HERE>                     ` |
 
-### [Typescript](https://facebook.github.io/react-native/blog/2018/05/07/using-typescript-with-react-native) API:
+ __`TSLocationManagerLicense`__.  Paste the contents of your license key into the __`value`__.
 
-For those using [Typescript](https://facebook.github.io/react-native/blog/2018/05/07/using-typescript-with-react-native) (__recommended__), you can also `import` the interfaces:
-```javascript
-import BackgroundGeolocation, {
-  State,
-  Config,
-  Location,
-  LocationError,
-  Geofence,
-  GeofenceEvent,
-  GeofencesChangeEvent,
-  HeartbeatEvent,
-  HttpEvent,
-  MotionActivityEvent,
-  MotionChangeEvent,
-  ProviderChangeEvent,
-  ConnectivityChangeEvent
-} from "react-native-background-geolocation";
+## :large_blue_diamond: Using the plugin ##
 
+```javascript
+import BackgroundGeolocation from "react-native-background-geolocation";
 ```
 
-For more information, see [this blog post](https://medium.com/@transistorsoft/new-feature-typescript-api-4a160a2c853b)
-
 ## :large_blue_diamond: Example
 
 There are three main steps to using `BackgroundGeolocation`
@@ -139,32 +130,29 @@ There are three main steps to using `BackgroundGeolocation`
 3. `.start()` the plugin.
 
 > [!WARNING]
-> Do not execute *any* API method which will require accessing location-services until the **[`.ready(config)`](https://transistorsoft.github.io/react-native-background-geolocation/classes/backgroundgeolocation.html#ready)** method resolves ([Read its API docs](https://transistorsoft.github.io/react-native-background-geolocation/classes/backgroundgeolocation.html#ready)), For example: 
+> Do not execute *any* API method which will require accessing location-services until the **[`.ready(config)`](https://transistorsoft.github.io/react-native-background-geolocation/latest/interfaces/BackgroundGeolocation.html#ready)** method resolves ([Read its API docs](https://transistorsoft.github.io/react-native-background-geolocation/latest/interfaces/BackgroundGeolocation.html#ready)), For example: 
 >- `.getCurrentPosition` 
 >- `.watchPosition`
 >- `.start`
 
 ```javascript
 // NO!  .ready() has not resolved.
-BackgroundGeolocation.getCurrentPosition(options);
-BackgroundGeolocation.start();
+await BackgroundGeolocation.getCurrentPosition(options);
+await BackgroundGeolocation.start();
+
+// First call .ready(config)
+const state = await BackgroundGeolocation.ready(config);
+const location = await BackgroundGeolocation.getCurrentPosition(options);
+await BackgroundGeolocation.start();  
 
-BackgroundGeolocation.ready(config).then((state) => {
-  // YES -- .ready() has now resolved.
-  BackgroundGeolocation.getCurrentPosition(options);
-  BackgroundGeolocation.start();  
-});
 
 // NO!  .ready() has not resolved.
-BackgroundGeolocation.getCurrentPosition(options);
-BackgroundGeolocation.start();
+const location = await BackgroundGeolocation.getCurrentPosition(options);
+await BackgroundGeolocation.start();
 ```
 
 
-### Example 1. &mdash; React *Functional Component*
-
-<details>
-  <summary>Show Source</summary>
+### Example
 
 ```javascript
 
@@ -206,24 +194,32 @@ const HelloWorld = () => {
     /// 2. ready the plugin.
     BackgroundGeolocation.ready({
       // Geolocation Config
-      desiredAccuracy: BackgroundGeolocation.DESIRED_ACCURACY_HIGH,
-      distanceFilter: 10,
-      // Activity Recognition
-      stopTimeout: 5,
-      // Application config
-      debug: true, // <-- enable this hear sounds for background-geolocation life-cycle.
-      logLevel: BackgroundGeolocation.LOG_LEVEL_VERBOSE,
-      stopOnTerminate: false,   // <-- Allow the background-service to continue tracking when user closes the app.
-      startOnBoot: true,        // <-- Auto start tracking when device is powered-up.
-      // HTTP / SQLite config
-      url: 'http://yourserver.com/locations',
-      batchSync: false,       // <-- [Default: false] Set true to sync locations to server in a single HTTP request.
-      autoSync: true,         // <-- [Default: true] Set true to sync each location to server as it arrives.
-      headers: {              // <-- Optional HTTP headers
-        "X-FOO": "bar"
+      geolocation: {
+        desiredAccuracy: BackgroundGeolocation.DesiredAccuracy.High
+        distanceFilter: 10,
+        stopTimeout: 5
+      },
+      // Logger Config
+      logger: {      
+        debug: true, // <-- enable this hear sounds for background-geolocation life-cycle.
+        logLevel: BackgroundGeolocation.LogLevel.Verbose
       },
-      params: {               // <-- Optional HTTP params
-        "auth_token": "maybe_your_server_authenticates_via_token_YES?"
+      // Application config
+      app: {
+        stopOnTerminate: false,   // <-- Allow the background-service to continue tracking when user closes the app.
+        startOnBoot: true         // <-- Auto start tracking when device is powered-up.
+      },      
+      // Http Config
+      http: {
+        url: 'http://yourserver.com/locations',
+        batchSync: false,       // <-- [Default: false] Set true to sync locations to server in a single HTTP request.
+        autoSync: true,         // <-- [Default: true] Set true to sync each location to server as it arrives.
+        headers: {              // <-- Optional HTTP headers
+          "X-FOO": "bar"
+        },
+        params: {               // <-- Optional HTTP params
+          "auth_token": "maybe_your_server_authenticates_via_token_YES?"
+        }
       }
     }).then((state) => {
       setEnabled(state.enabled)
@@ -263,157 +259,10 @@ const HelloWorld = () => {
 export default HelloWorld;
 ```
 
-</details>
-
-### Example 2. &mdash; React *Class Component*
-
-<details>
-  <summary>Show Source</summary>
-
-```javascript
-import React from 'react';
-import {
-  Switch,
-  Text,
-  View,
-} from 'react-native';
-
-import BackgroundGeolocation, {
-  Location,
-  Subscription
-} from "react-native-background-geolocation";
-
-export default class HelloWorld extends React.Component {
-  subscriptions:Subscription[] = [];
-  state:any = {};
-  constructor(props:any) {
-    super(props);
-    this.state = {
-      enabled: false,
-      location: ''
-    }
-  }
-
-  componentDidMount() {
-    /// 1.  Subscribe to BackgroundGeolocation events.
-    this.subscriptions.push(BackgroundGeolocation.onLocation((location) => {
-      console.log('[onLocation]', location);
-      this.setState({location: JSON.stringify(location, null, 2)})
-    }, (error) => {
-      console.log('[onLocation] ERROR:', error);
-    }))
-
-    this.subscriptions.push(BackgroundGeolocation.onMotionChange((event) => {
-      console.log('[onMotionChange]', event);
-    }))
-
-    this.subscriptions.push(BackgroundGeolocation.onActivityChange((event) => {
-      console.log('[onActivityChange]', event);
-    }))
-
-    this.subscriptions.push(BackgroundGeolocation.onProviderChange((event) => {
-      console.log('[onProviderChange]', event);
-    }))
-
-    /// 2. ready the plugin.
-    BackgroundGeolocation.ready({
-      // Geolocation Config
-      desiredAccuracy: BackgroundGeolocation.DESIRED_ACCURACY_HIGH,
-      distanceFilter: 10,
-      // Activity Recognition
-      stopTimeout: 5,
-      // Application config
-      debug: true, // <-- enable this hear sounds for background-geolocation life-cycle.
-      logLevel: BackgroundGeolocation.LOG_LEVEL_VERBOSE,
-      stopOnTerminate: false,   // <-- Allow the background-service to continue tracking when user closes the app.
-      startOnBoot: true,        // <-- Auto start tracking when device is powered-up.
-      // HTTP / SQLite config
-      url: 'http://yourserver.com/locations',
-      batchSync: false,       // <-- [Default: false] Set true to sync locations to server in a single HTTP request.
-      autoSync: true,         // <-- [Default: true] Set true to sync each location to server as it arrives.
-      headers: {              // <-- Optional HTTP headers
-        "X-FOO": "bar"
-      },
-      params: {               // <-- Optional HTTP params
-        "auth_token": "maybe_your_server_authenticates_via_token_YES?"
-      }
-    }).then((state) => {
-      this.setState({enabled: state.enabled});
-      console.log("- BackgroundGeolocation is configured and ready: ", state.enabled);
-    })
-  }
-
-  /// When view is destroyed (or refreshed during development live-reload),
-  /// remove BackgroundGeolocation event subscriptions.
-  componentWillUnmount() {
-    this.subscriptions.forEach((subscription) => subscription.remove());
-  }
-
-  onToggleEnabled(value:boolean) {
-    console.log('[onToggleEnabled]', value);
-    this.setState({enabled: value})
-    if (value) {
-      BackgroundGeolocation.start();
-    } else {
-      this.setState({location: ''});
-      BackgroundGeolocation.stop();
-    }
-  }
-
-  render() {
-    return (
-      <View style={{alignItems:'center'}}>
-        <Text>Click to enable BackgroundGeolocation</Text>
-        <Switch value={this.state.enabled} onValueChange={this.onToggleEnabled.bind(this)} />
-        <Text style={{fontFamily:'monospace', fontSize:12}}>{this.state.location}</Text>
-      </View>
-    )
-  }
-}
-```
-</details>
-
-### Promise API
-
-The `BackgroundGeolocation` Javascript API supports [Promises](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) for *nearly* every method (the exceptions are **`#watchPosition`** and adding event-listeners via **`#onXXX`** method (eg: `onLocation`).  For more information, see the [API Documentation](https://transistorsoft.github.io/react-native-background-geolocation-android)
-
-```javascript
-BackgroundGeolocation.ready({
-  desiredAccuracy: BackgroundGeolocation.DESIRED_ACCURACY_HIGH, 
-  distanceFilter: 50
-}).then(state => {
-  console.log('- BackgroundGeolocation is ready: ', state);
-}).catch(error => {
-  console.warn('- BackgroundGeolocation error: ', error);
-});
-
-// Or use await in an async function
-try {
-  const state = await BackgroundGeolocation.ready({
-    desiredAccuracy: BackgroundGeolocation.DESIRED_ACCURACY_HIGH, 
-    distanceFilter: 50
-  })
-  console.log('- BackgroundGeolocation is ready: ', state);
-} catch (error) {
-  console.warn('- BackgroundGeolocation error: ', error);
-}
-```
-
-## :large_blue_diamond: [Demo Application](https://github.com/transistorsoft/rn-background-geolocation-demo)
-
-A fully-featured [Demo App](https://github.com/transistorsoft/rn-background-geolocation-demo) is available in its own public repo.  After first cloning that repo, follow the installation instructions in the **README** there.  This demo-app includes a settings-screen allowing you to quickly experiment with all the different settings available for each platform.
-
-![Home](https://dl.dropboxusercontent.com/s/wa43w1n3xhkjn0i/home-framed-350.png?dl=1)
-![Settings](https://dl.dropboxusercontent.com/s/8oad228siog49kt/settings-framed-350.png?dl=1)
-
-
-## :large_blue_diamond: [Simple Testing Server](https://github.com/transistorsoft/background-geolocation-console)
-
-A simple Node-based [web-application](https://github.com/transistorsoft/background-geolocation-console) with SQLite database is available for field-testing and performance analysis.  If you're familiar with Node, you can have this server up-and-running in about **one minute**.
+## :large_blue_diamond: [Demo Application](example)
 
-![](https://dl.dropboxusercontent.com/s/px5rzz7wybkv8fs/background-geolocation-console-map.png?dl=1)
+Clone this repo and run the [/example](example) app.
 
-![](https://dl.dropboxusercontent.com/s/tiy5b2oivt0np2y/background-geolocation-console-grid.png?dl=1)
 
 # License
 

package/RNBackgroundGeolocation.podspec

@@ -27,7 +27,7 @@ Pod::Spec.new do |s|
   s.preserve_paths      = 'docs', 'CHANGELOG.md', 'LICENSE', 'package.json', 'RNBackgroundGeolocation.ios.js'
 
   s.dependency 'CocoaLumberjack', '~> 3.8.5'
-  s.dependency 'TSLocationManager', '~> 4.0.0-beta.5'
+  s.dependency 'TSLocationManager', '~> 4.0.0'
 
   s.libraries           = 'sqlite3', 'z', 'stdc++'
   s.resource_bundles    = {
@@ -42,4 +42,4 @@ Pod::Spec.new do |s|
   else
     s.dependency 'React-Core'
   end
-end
+end

package/android/build.gradle

@@ -9,6 +9,7 @@ def DEFAULT_TARGET_SDK_VERSION                      = 36
 
 // Plugin dependencies
 def DEFAULT_PLAY_SERVICES_LOCATION_VERSION          = "21.3.0"
+def DEFAULT_TSLOCATIONMANAGER_VERSION               = "4.0.+"
 def DEFAULT_OK_HTTP_VERSION                         = "4.12.0"
 def DEFAULT_ANDROID_PERMISSIONS_VERSION             = "2.1.6"
 def DEFAULT_EVENTBUS_VERSION                        = "3.3.1"
@@ -60,9 +61,16 @@ repositories{
 
 dependencies {
     def playServicesLocationVersion = safeExtGet('playServicesLocationVersion', safeExtGet('googlePlayServicesLocationVersion', DEFAULT_PLAY_SERVICES_LOCATION_VERSION))
-
+    def tslocationmanagerVersion = safeExtGet('tslocationmanagerVersion', DEFAULT_TSLOCATIONMANAGER_VERSION)
     implementation "com.facebook.react:react-native:${safeExtGet('reactNativeVersion', '+')}"
-    implementation "com.google.android.gms:play-services-location:$playServicesLocationVersion"
-    implementation "com.transistorsoft:tslocationmanager:4.0.0-beta.+"
+
+    def locationMajorVersion = playServicesLocationVersion.split('\\.')[0] as int
+    if (locationMajorVersion >= 21) {
+        api "com.transistorsoft:tslocationmanager:$tslocationmanagerVersion"
+    } else {
+        api "com.transistorsoft:tslocationmanager-gms20:$tslocationmanagerVersion"
+    }
+        
+    implementation "com.google.android.gms:play-services-location:$playServicesLocationVersion"    
     implementation 'org.greenrobot:eventbus:3.3.1'
 }

package/android/src/main/java/com/transistorsoft/rnbackgroundgeolocation/HeadlessTask.java

@@ -39,7 +39,7 @@ public class HeadlessTask {
         TSConfig config = TSConfig.getInstance(event.getContext());
 
         String name = event.getName();
-        TSLog.logger.debug("\uD83D\uDC80  event: " + name);
+        TSLog.d("\uD83D\uDC80  event: " + name);
 
         WritableMap clientEvent = new WritableNativeMap();
         Map<String, ?> params = null;
@@ -83,7 +83,7 @@ public class HeadlessTask {
         } else if (name.equals(EventName.AUTHORIZATION)) {
             params = event.getAuthorizationEvent().toMap();
         } else {
-            TSLog.logger.warn(TSLog.warn("Unknown Headless Event: " + name));
+            TSLog.w(TSLog.warn("Unknown Headless Event: " + name));
             clientEvent.putString("error", "Unknown event: " + name);
             clientEvent.putNull("params");
         }
@@ -98,18 +98,18 @@ public class HeadlessTask {
                     .setParams(clientEvent)
                     .setTimeout(TASK_TIMEOUT)
                     .setOnInvokeCallback((reactContext, task) -> {
-                        //TSLog.logger.debug("*** onInvoke: " + task.getId());
+                        //TSLog.d("*** onInvoke: " + task.getId());
                     })
                     .setOnFinishCallback(taskId -> {
-                        //TSLog.logger.debug("*** onFinish: " + taskId);
+                        //TSLog.d("*** onFinish: " + taskId);
                     })
                     .setOnErrorCallback((task, e) -> {
-                        TSLog.logger.warn("⚠\uFE0F  HeadlessTaskError: " + e.getMessage() + ": " + task.toString());
+                        TSLog.w("⚠\uFE0F  HeadlessTaskError: " + e.getMessage() + ": " + task.toString());
                     })
                     .build()
             );
         } catch (Exception e) {
-            TSLog.logger.warn(TSLog.warn("Failed invoke HeadlessTask " + name + ".  Task ignored:  " + e.getMessage()));
+            TSLog.w("Failed invoke HeadlessTask " + name + ".  Task ignored:  " + e.getMessage());
             e.printStackTrace();
         }
     }
@@ -124,7 +124,7 @@ public class HeadlessTask {
         try {
             HeadlessTaskManager.getInstance().finishTask(event.getContext(), event.getTaskId());
         } catch (Exception e) {
-            TSLog.logger.warn(TSLog.warn(e.getMessage()));
+            TSLog.w(e.getMessage());
         }
     }
 }

package/android/src/main/java/com/transistorsoft/rnbackgroundgeolocation/HeadlessTaskManager.java

@@ -161,7 +161,7 @@ public class HeadlessTaskManager implements HeadlessJsTaskEventListener {
         removeTask(task);
         task.onFinish();
 
-        TSLog.logger.debug("[onHeadlessJsTaskFinish] taskId: " + taskId);
+        TSLog.d("[onHeadlessJsTaskFinish] taskId: " + taskId);
     }
 
     private ReactNativeHost getReactNativeHost(Context context) {
@@ -189,7 +189,7 @@ public class HeadlessTaskManager implements HeadlessJsTaskEventListener {
                 Method getCurrentReactContext = reactHost.getClass().getMethod("getCurrentReactContext");
                 return (ReactContext) getCurrentReactContext.invoke(reactHost);
             } catch (Exception e) {
-                TSLog.logger.error(TSLog.error( "Reflection error getCurrentReactContext: " + e.getMessage()), e);
+                TSLog.e(TSLog.error( "Reflection error getCurrentReactContext: " + e.getMessage()), e);
             }
         }
         final ReactInstanceManager reactInstanceManager = getReactNativeHost(context).getReactInstanceManager();
@@ -206,7 +206,7 @@ public class HeadlessTaskManager implements HeadlessJsTaskEventListener {
             return;
         }
         if (mIsInitializingReactContext.compareAndSet(false, true)) {
-            TSLog.logger.debug( "[createReactContextAndScheduleTask] initialize ReactContext");
+            TSLog.d( "[createReactContextAndScheduleTask] initialize ReactContext");
             final Object reactHost = getReactHost(context);
             if (isBridglessArchitectureEnabled()) { // NEW arch
                 ReactInstanceEventListener callback = new ReactInstanceEventListener() {
@@ -218,7 +218,7 @@ public class HeadlessTaskManager implements HeadlessJsTaskEventListener {
                             Method removeReactInstanceEventListener = reactHost.getClass().getMethod("removeReactInstanceEventListener", ReactInstanceEventListener.class);
                             removeReactInstanceEventListener.invoke(reactHost, this);
                         } catch (Exception e) {
-                            TSLog.logger.error(TSLog.error("HeadlessTask reflection error removeReactInstanceEventListener: ") + e);
+                            TSLog.e(TSLog.error("HeadlessTask reflection error removeReactInstanceEventListener: ") + e);
                         }
                     }
                 };
@@ -228,7 +228,7 @@ public class HeadlessTaskManager implements HeadlessJsTaskEventListener {
                     Method startReactHost = reactHost.getClass().getMethod("start");
                     startReactHost.invoke(reactHost);
                 } catch (Exception e) {
-                    TSLog.logger.error(TSLog.error("HeadlessTask reflection error ReactHost start: " + e.getMessage()), e);
+                    TSLog.e(TSLog.error("HeadlessTask reflection error ReactHost start: " + e.getMessage()), e);
                 }
             } else { // OLD arch
                 final ReactInstanceManager reactInstanceManager = getReactNativeHost(context).getReactInstanceManager();
@@ -363,7 +363,7 @@ public class HeadlessTaskManager implements HeadlessJsTaskEventListener {
 
         boolean invoke(ReactContext reactContext) throws IllegalStateException {
             if (mReactTaskId > 0) {
-                TSLog.logger.warn(TSLog.warn("Task already invoked <IGNORED>: " + this));
+                TSLog.w(TSLog.warn("Task already invoked <IGNORED>: " + this));
                 return true;
             }
             HeadlessJsTaskContext headlessJsTaskContext = HeadlessJsTaskContext.getInstance(reactContext);

package/package.json

@@ -1,7 +1,16 @@
 {
-  "name": "react-native-background-geolocation",
-  "version": "5.0.0-beta.4",
+
+  "name": "react-native-background-geolocation",  
+  "version": "5.0.1",
   "description": "The most sophisticated cross-platform background location-tracking & geofencing module with battery-conscious motion-detection intelligence",
+  "scripts": {
+    "build": "yarn run build:expo",
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "build:expo": "rimraf expo/plugin/build && tsc --build ./expo/plugin",
+    "docs": "node ./scripts/generate-docs.mjs",
+    "docs:publish": "./scripts/publish-docs.sh",
+    "prepublishOnly": "npm run build"
+  },
   "codegenConfig": {
     "name": "RNBackgroundGeolocation",
     "type": "modules",
@@ -12,7 +21,7 @@
     "ios": {
       "swiftModuleName": "RNBackgroundGeolocation",
       "packageName": "RNBackgroundGeolocation"
-    }
+    }    
   },
   "main": "src/index.js",
   "repository": {
@@ -50,12 +59,5 @@
     "rimraf": "^5.0.0",
     "typedoc": "^0.28.14",
     "typescript": "^5.6.0"
-  },
-  "scripts": {
-    "build": "yarn run build:expo",
-    "test": "echo \"Error: no test specified\" && exit 1",
-    "build:expo": "rimraf expo/plugin/build && tsc --build ./expo/plugin",
-    "docs": "node ./scripts/generate-docs.mjs",
-    "docs:publish": "./scripts/publish-docs.sh"
   }
-}
+}

package/src/Logger.js

@@ -3,8 +3,6 @@
 
 import NativeModule from "./NativeModule";
 
-const RNBackgroundGeolocation = NativeModule; // uses the same getNativeBGGeo() under the hood
-
 const LOG_LEVEL_DEBUG = "debug";
 const LOG_LEVEL_NOTICE = "notice";
 const LOG_LEVEL_INFO = "info";
@@ -15,12 +13,19 @@ const ORDER_ASC = 1;
 const ORDER_DESC = -1;
 
 function log(level, msg) {
-  // You can either:
-  // 1) call the native logger via NativeModule.logger
-  //    NativeModule.logger[level](msg);
-  // or
-  // 2) just use the native `log` directly if exposed:
-  RNBackgroundGeolocation.log(level, msg);
+  // Call the native logger via NativeModule.logger[level](msg),
+  // fallback to debug if missing.
+  if (
+    NativeModule.logger &&
+    typeof NativeModule.logger[level] === 'function'
+  ) {
+    NativeModule.logger[level](msg);
+  } else if (
+    NativeModule.logger &&
+    typeof NativeModule.logger.debug === 'function'
+  ) {
+    NativeModule.logger.debug(msg);
+  }
 }
 
 function validateQuery(query) {
@@ -45,18 +50,18 @@ export default class Logger {
   static notice(msg) { log(LOG_LEVEL_NOTICE, msg); }
 
   static getLog(query) {
-    return RNBackgroundGeolocation.getLog(validateQuery(query));
+    return NativeModule.getLog(validateQuery(query));
   }
 
   static emailLog(email, query) {    
-    return RNBackgroundGeolocation.emailLog(email, validateQuery(query));
+    return NativeModule.emailLog(email, validateQuery(query));
   }
 
   static uploadLog(url, query) {
-    return RNBackgroundGeolocation.uploadLog(url, validateQuery(query));
+    return NativeModule.uploadLog(url, validateQuery(query));
   }
 
   static destroyLog() {
-    return RNBackgroundGeolocation.destroyLog();
+    return NativeModule.destroyLog();
   }
 }

package/src/NativeModule.js

@@ -395,16 +395,20 @@ export default class NativeModule {
     return RNBackgroundGeolocation.setLogLevel(value);
   }
 
-  static getLog() {
-    return RNBackgroundGeolocation.getLog();
+  static getLog(query) {
+    return RNBackgroundGeolocation.getLog(query);
   }
 
   static destroyLog() {
-    return RNBackgroundGeolocation.destroyLog();    
+    return RNBackgroundGeolocation.destroyLog();
   }
 
   static emailLog(email, query) {
-    return RNBackgroundGeolocation.emailLog(email, query);  
+    return RNBackgroundGeolocation.emailLog(email, query);
+  }
+
+  static uploadLog(url, query) {
+    return RNBackgroundGeolocation.uploadLog(url, query);
   }
 
   static isPowerSaveMode() {

package/src/declarations/interfaces/State.d.ts

@@ -35,6 +35,11 @@ declare module "react-native-background-geolocation" {
     * - [[getOdometer]]
     */
     odometer: number;
+    /**
+     * The estimated error (in meters) of the current odometer value.
+     */
+    odometerError: number;
+
     /**
     * `true` when the iOS app was launched in the background.  Always `false` for Android.
     * iOS apps can be launched in the background due to a background-fetch event, geofence events or exiting the [[Config.stationaryRadius]].

package/src/native/specs/NativeBackgroundGeolocation.ts

@@ -44,6 +44,10 @@ export interface Spec extends TurboModule {
 
   // Logging
   log(level: string, message: string): Promise<void>;
+  getLog(query: Object): Promise<string>;
+  emailLog(email: string, query: Object): Promise<void>;
+  uploadLog(url: string, query: Object): Promise<void>;
+  destroyLog(): Promise<void>;
 }
 
 export default TurboModuleRegistry.getEnforcing<Spec>('RNBackgroundGeolocation');