react-native-background-geolocation 5.1.0 → 5.2.0

package/README.md

@@ -21,14 +21,14 @@ The SDK uses **motion-detection** APIs (accelerometer, gyroscope, magnetometer)
 ## :books: Documentation
 
 ### <img src="assets/images/platforms/react-native.svg" width="20" height="20"> React Native
-- [Setup](https://docs.transistorsoft.com/typescript/setup/?tab=react-native)
-- [API Reference](https://docs.transistorsoft.com/typescript/BackgroundGeolocation/)
-- [Example](https://docs.transistorsoft.com/typescript/examples/?tab=react-native)
+- [Setup](https://docs.transistorsoft.com/react-native/setup/)
+- [API Reference](https://docs.transistorsoft.com/react-native/BackgroundGeolocation/)
+- [Example](https://docs.transistorsoft.com/react-native/examples/)
 
 ### <img src="assets/images/platforms/expo.svg" width="20" height="20"> Expo
-- [Setup](https://docs.transistorsoft.com/typescript/setup/?tab=expo)
-- [API Reference](https://docs.transistorsoft.com/typescript/BackgroundGeolocation/)
-- [Example](https://docs.transistorsoft.com/typescript/examples/?tab=react-native)
+- [Setup](https://docs.transistorsoft.com/react-native/setup/)
+- [API Reference](https://docs.transistorsoft.com/react-native/BackgroundGeolocation/)
+- [Example](https://docs.transistorsoft.com/react-native/examples/)
 
 ---
 
@@ -38,7 +38,7 @@ The SDK uses **motion-detection** APIs (accelerometer, gyroscope, magnetometer)
 > The SDK is **fully functional in `DEBUG` builds** — no license required. Try before you buy.
 
 A license is required only for **`RELEASE` builds** on Android.
-[Purchase a license](https://shop.transistorsoft.com/products/react-native-background-geolocation)
+[Purchase a license](https://docs.transistorsoft.com)
 
 ---
 
@@ -57,8 +57,8 @@ See [`/example`](example/README.md) — example apps are included in this repo.
 | <img src="assets/images/platforms/flutter.svg" width="16" height="16"> [Flutter](https://github.com/transistorsoft/flutter_background_geolocation) | `flutter_background_geolocation` |
 | <img src="assets/images/platforms/capacitor.svg" width="16" height="16"> [Capacitor](https://github.com/transistorsoft/capacitor-background-geolocation) | `@transistorsoft/capacitor-background-geolocation` |
 | <img src="assets/images/platforms/cordova.svg" width="16" height="16"> [Cordova](https://github.com/transistorsoft/cordova-background-geolocation-lt) | `cordova-background-geolocation-lt` |
-| <img src="assets/images/platforms/swift.svg" width="16" height="16"> [Swift / iOS](https://github.com/transistorsoft/background-geolocation) | `background-geolocation` |
-| <img src="assets/images/platforms/kotlin.svg" width="16" height="16"> [Kotlin / Android](https://github.com/transistorsoft/background-geolocation) | `background-geolocation` |
+| <img src="assets/images/platforms/swift.svg" width="16" height="16"> [Swift / iOS](https://github.com/transistorsoft/native-background-geolocation) | `background-geolocation` |
+| <img src="assets/images/platforms/kotlin.svg" width="16" height="16"> [Kotlin / Android](https://github.com/transistorsoft/native-background-geolocation) | `background-geolocation` |
 
 ---
 

package/RNBackgroundGeolocation.podspec

@@ -26,7 +26,8 @@ Pod::Spec.new do |s|
   s.source_files        = 'ios/RNBackgroundGeolocation/*.{h,m,mm}'
   s.preserve_paths      = 'docs', 'CHANGELOG.md', 'LICENSE', 'package.json', 'RNBackgroundGeolocation.ios.js'
 
-  s.dependency 'TSLocationManager', '~> 4.1.0'
+  tslm_version = ENV['TSLOCATIONMANAGER_VERSION'] || '~> 4.2.0'
+  s.dependency 'TSLocationManager', tslm_version
 
   s.libraries           = 'sqlite3', 'z', 'stdc++'
   s.resource_bundles    = {

package/android/build.gradle

@@ -9,7 +9,7 @@ def DEFAULT_TARGET_SDK_VERSION                      = 35
 
 // Plugin dependencies
 def DEFAULT_PLAY_SERVICES_LOCATION_VERSION          = "21.3.0"
-def DEFAULT_TSLOCATIONMANAGER_VERSION               = "4.1.+"
+def DEFAULT_TSLOCATIONMANAGER_VERSION               = "4.2.+"
 def DEFAULT_OK_HTTP_VERSION                         = "4.12.0"
 def DEFAULT_ANDROID_PERMISSIONS_VERSION             = "2.1.6"
 def DEFAULT_EVENTBUS_VERSION                        = "3.3.1"

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

@@ -62,6 +62,8 @@ public class HeadlessTask {
             params = event.getProviderChangeEvent().toMap();
         } else if (name.equals(EventName.ACTIVITYCHANGE)) {
             params = event.getActivityChangeEvent().toMap();
+        } else if (name.equals(EventName.LOCATIONFILTER)) {
+            params = event.getLocationFilterEvent().toMap();
         } else if (name.equals(EventName.SCHEDULE)) {
             params = config.toMap(false);
         } else if (name.equals(EventName.BOOT)) {

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

@@ -47,6 +47,7 @@ import com.transistorsoft.locationmanager.data.LocationModel;
 import com.transistorsoft.locationmanager.data.SQLQuery;
 import com.transistorsoft.locationmanager.device.DeviceInfo;
 import com.transistorsoft.locationmanager.event.ActivityChangeEvent;
+import com.transistorsoft.locationmanager.event.LocationFilterEvent;
 import com.transistorsoft.locationmanager.event.AuthorizationEvent;
 import com.transistorsoft.locationmanager.event.ConnectivityChangeEvent;
 import com.transistorsoft.locationmanager.event.GeofenceEvent;
@@ -118,6 +119,7 @@ public class RNBackgroundGeolocationModule
         mEvents.add(EventName.LOCATION);
         mEvents.add(EventName.MOTIONCHANGE);
         mEvents.add(EventName.ACTIVITYCHANGE);
+        mEvents.add(EventName.LOCATIONFILTER);
         mEvents.add(EventName.PROVIDERCHANGE);
         mEvents.add(EventName.GEOFENCESCHANGE);
         mEvents.add(EventName.GEOFENCE);
@@ -146,6 +148,7 @@ public class RNBackgroundGeolocationModule
         adapter.onLocation(new LocationCallback());
         adapter.onMotionChange(new MotionChangeCallback());
         adapter.onActivityChange(new ActivityChangeCallback());
+        adapter.onLocationFilter(new LocationFilterCallback());
         adapter.onLocationProviderChange(new LocationProviderChangeCallback());
         adapter.onGeofencesChange(new GeofencesChangeCallback());
         adapter.onGeofence(new GeofenceCallback());
@@ -199,6 +202,15 @@ public class RNBackgroundGeolocationModule
         }
     }
 
+    /**
+     * locationfilter event callback
+     */
+    private class LocationFilterCallback implements TSLocationFilterCallback {
+        @Override public void onLocationFilter(LocationFilterEvent event) {
+            sendEvent(EventName.LOCATIONFILTER, mapToWritableMap(event.toMap()));
+        }
+    }
+
     /**
      * providerchange event callback
      */

package/ios/RNBackgroundGeolocation/RNBackgroundGeolocation.mm

@@ -30,6 +30,7 @@ static NSString *const EVENT_WATCHPOSITION      = @"watchposition";
 static NSString *const EVENT_PROVIDERCHANGE     = @"providerchange";
 static NSString *const EVENT_MOTIONCHANGE       = @"motionchange";
 static NSString *const EVENT_ACTIVITYCHANGE     = @"activitychange";
+static NSString *const EVENT_LOCATIONFILTER     = @"locationfilter";
 static NSString *const EVENT_GEOFENCESCHANGE    = @"geofenceschange";
 static NSString *const EVENT_HTTP               = @"http";
 static NSString *const EVENT_SCHEDULE           = @"schedule";
@@ -89,6 +90,9 @@ RCT_EXPORT_MODULE();
         NSDictionary *params = @{@"activity": event.activity, @"confidence": @(event.confidence)};
         [me sendEvent:EVENT_ACTIVITYCHANGE body:params];
     }];
+    [locationManager onLocationFilter:^(TSLocationFilterEvent *event) {
+        [me sendEvent:EVENT_LOCATIONFILTER body:[event toDictionary]];
+    }];
     [locationManager onHeartbeat:^(TSHeartbeatEvent *event) {
         [me sendEvent:EVENT_HEARTBEAT body:[event toDictionary]];
     }];
@@ -131,6 +135,7 @@ RCT_EXPORT_MODULE();
         EVENT_PROVIDERCHANGE,
         EVENT_MOTIONCHANGE,
         EVENT_ACTIVITYCHANGE,
+        EVENT_LOCATIONFILTER,
         EVENT_GEOFENCESCHANGE,
         EVENT_POWERSAVECHANGE,
         EVENT_HTTP,

package/package.json

@@ -1,7 +1,7 @@
 {
 
   "name": "react-native-background-geolocation",  
-  "version": "5.1.0",
+  "version": "5.2.0",
   "description": "The most sophisticated cross-platform background location-tracking & geofencing module with battery-conscious motion-detection intelligence",
   "scripts": {
     "build": "yarn run build:expo",
@@ -41,7 +41,7 @@
   ],
   "dependencies": {
     "@babel/runtime": "^7.26.0",
-    "@transistorsoft/background-geolocation-types": "^5.0.1",
+    "@transistorsoft/background-geolocation-types": "^5.2.0",
     "tslib": "^2.6.3"
   },
   "author": "Chris Scott <chris@transistorsoft.com>",

package/src/index.js

@@ -89,6 +89,7 @@ export default class BackgroundGeolocation {
   static get EVENT_HEARTBEAT()             { return Event.Heartbeat; }
   static get EVENT_PROVIDERCHANGE()        { return Event.ProviderChange; }
   static get EVENT_ACTIVITYCHANGE()        { return Event.ActivityChange; }
+  static get EVENT_LOCATIONFILTER()        { return Event.LocationFilter; }
   static get EVENT_GEOFENCE()              { return Event.Geofence; }
   static get EVENT_GEOFENCESCHANGE()       { return Event.GeofencesChange; }
   static get EVENT_ENABLEDCHANGE()         { return Event.EnabledChange; }
@@ -275,6 +276,10 @@ export default class BackgroundGeolocation {
     return this.addListener(Event.ActivityChange, callback);
   }
 
+  static onLocationFilter(callback) {
+    return this.addListener(Event.LocationFilter, callback);
+  }
+
   static onGeofence(callback) {
     return this.addListener(Event.Geofence, callback);
   }

package/tests/location-filter-event.test.js

@@ -0,0 +1,30 @@
+jest.mock('../src/NativeModule', () => ({
+  addListener: jest.fn(() => ({ remove: jest.fn() })),
+}));
+
+const NativeModule = require('../src/NativeModule');
+const BG = require('../src/index.js').default;
+const Shared = require('@transistorsoft/background-geolocation-types');
+
+// onLocationFilter event wiring (issue #2585).
+test('exposes the locationfilter event name + subscription method', () => {
+  // Shared enum carries the new event name.
+  expect(Shared.Event.LocationFilter).toBe('locationfilter');
+
+  // Backward-compat static getter mirrors the shared enum.
+  expect(BG.EVENT_LOCATIONFILTER).toBe('locationfilter');
+
+  // Subscription method is exposed.
+  expect(typeof BG.onLocationFilter).toBe('function');
+});
+
+test('onLocationFilter routes through the native bridge with the locationfilter event', () => {
+  NativeModule.addListener.mockClear();
+  const cb = jest.fn();
+
+  const subscription = BG.onLocationFilter(cb);
+
+  expect(NativeModule.addListener).toHaveBeenCalledWith('locationfilter', cb);
+  expect(subscription).toBeDefined();
+  expect(typeof subscription.remove).toBe('function');
+});