@josuelmm/cordova-background-geolocation 4.2.0 → 4.2.2

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [4.2.2](https://github.com/josuelmm/cordova-background-geolocation/tree/4.2.2) (2026-05-09)
+
+### Fixed
+- `PostLocationTask.postLocation`: cast del retorno de `LocationTemplate.locationToJson` (que es `Object` — `JSONObject` para `HashMapLocationTemplate`, `JSONArray` para `ArrayListLocationTemplate`) a la sobrecarga correcta de `HttpPostService.postJSON`. Bug latente que rompía la compilación con consumidores Capacitor (Gradle 8.x).
+- `BackgroundGeolocationPlugin.buildDiagnostics`: envolver `facade.locationServicesEnabled()` en `try/catch (PluginException)`. El método declara `throws JSONException` pero no `PluginException`, lo que rompía el build cuando se invoca desde `getDiagnostics`.
+
 ## [4.2.0](https://github.com/josuelmm/cordova-background-geolocation/tree/4.2.0) (2026-05-08)
 
 ### Phase 8 — Real sensor fusion (accelerometer + gyroscope)

package/HISTORY.md

@@ -2,6 +2,13 @@
 
 **for cordova-plugin-background-geolocation**
 
+## [4.2.2] - 2026-05-09
+
+### Fixed
+- `PostLocationTask`: handle `LocationTemplate.locationToJson` returning `Object` (JSONObject vs JSONArray) — fixed compile failure under Capacitor / Gradle 8.x.
+- `BackgroundGeolocationPlugin.buildDiagnostics`: wrap `facade.locationServicesEnabled()` in `try/catch (PluginException)` — fixed unreported-checked-exception build error.
+- Plugin version: `4.2.2`.
+
 ## [4.2.0] - 2026-05-08
 
 ### Phase 8 — Real sensor fusion (accelerometer + gyroscope)

package/README.md

@@ -368,6 +368,12 @@ Subscribe with `BackgroundGeolocation.on(eventName, callback)`. Unsubscribe with
 
 Full event payloads and options: [Events](docs/events.md). Full API (all options, all methods): [API](docs/api.md).
 
+### New in 4.2.2
+
+- Build hotfixes — required when consuming the plugin via Capacitor (Gradle 8.x):
+  - `PostLocationTask.postLocation`: cast `LocationTemplate.locationToJson` (returns `Object`) to the right `HttpPostService.postJSON` overload.
+  - `BackgroundGeolocationPlugin.buildDiagnostics`: wrap `facade.locationServicesEnabled()` in `try/catch (PluginException)`.
+
 ### New in 4.2.0
 
 - **Real sensor fusion (Phase 8).** Optional accelerometer + gyroscope pipeline (`drivingEvents.sensorFusion: true`). On Android uses `Sensor.TYPE_LINEAR_ACCELERATION` + `Sensor.TYPE_GYROSCOPE`; on iOS uses `CMMotionManager.startDeviceMotionUpdatesToQueue` at 50 Hz.

package/android/CDVBackgroundGeolocation/src/main/java/com/tenforwardconsulting/bgloc/cordova/BackgroundGeolocationPlugin.java

@@ -89,7 +89,7 @@ public class BackgroundGeolocationPlugin extends CordovaPlugin implements Plugin
     public static final String ACTION_TRIGGER_SOS                   = "triggerSOS";
 
     /** Plugin version; keep in sync with plugin.xml. */
-    public static final String PLUGIN_VERSION = "4.2.0";
+    public static final String PLUGIN_VERSION = "4.2.2";
 
     private BackgroundGeolocationFacade facade;
 
@@ -519,7 +519,11 @@ public class BackgroundGeolocationPlugin extends CordovaPlugin implements Plugin
 
         // Common
         d.put("isRunning", facade.isRunning());
-        d.put("locationServicesEnabled", facade.locationServicesEnabled());
+        try {
+            d.put("locationServicesEnabled", facade.locationServicesEnabled());
+        } catch (PluginException e) {
+            d.put("locationServicesEnabled", JSONObject.NULL);
+        }
 
         try {
             Config cfg = facade.getConfig();

package/android/common/src/main/java/com/marianhello/bgloc/PostLocationTask.java

@@ -168,7 +168,10 @@ public class PostLocationTask {
     private boolean postLocation(BackgroundLocation location) {
         logger.debug("Executing PostLocationTask#postLocation");
 
-        JSONObject jsonLocation;
+        // LocationTemplate.locationToJson returns Object (JSONObject for HashMapLocationTemplate,
+        // JSONArray for ArrayListLocationTemplate). Resolve to the concrete type before calling
+        // the matching HttpPostService.postJSON overload.
+        Object jsonLocation;
         try {
             jsonLocation = mConfig.getTemplate().locationToJson(location);
         } catch (JSONException e) {
@@ -186,13 +189,17 @@ public class PostLocationTask {
         String method = mConfig.getHttpMethod();
         String mode = mConfig.getHttpMode();
         logger.debug("Posting to url: {} method: {} mode: {} headers: {}",
-                resolvedUrl, method, mode, mConfig.getHttpHeaders());
+                resolvedUrl, method, mConfig.getHttpHeaders());
         int responseCode;
 
         try {
             if ("single".equals(mode) || "GET".equals(method)) {
                 // GET cannot carry a JSON array body; force per-location request.
-                responseCode = HttpPostService.postJSON(resolvedUrl, jsonLocation, mConfig.getHttpHeaders(), method);
+                if (jsonLocation instanceof JSONArray) {
+                    responseCode = HttpPostService.postJSON(resolvedUrl, (JSONArray) jsonLocation, mConfig.getHttpHeaders(), method);
+                } else {
+                    responseCode = HttpPostService.postJSON(resolvedUrl, (JSONObject) jsonLocation, mConfig.getHttpHeaders(), method);
+                }
             } else {
                 JSONArray jsonLocations = new JSONArray();
                 jsonLocations.put(jsonLocation);

package/ios/CDVBackgroundGeolocation/CDVBackgroundGeolocation.m

@@ -513,7 +513,7 @@ static NSString * const TAG = @"CDVBackgroundGeolocation";
 - (void) getPluginVersion:(CDVInvokedUrlCommand*)command
 {
     NSLog(@"%@ #%@", TAG, @"getPluginVersion");
-    NSString *version = @"4.2.0"; // keep in sync with plugin.xml and Android PLUGIN_VERSION
+    NSString *version = @"4.2.2"; // keep in sync with plugin.xml and Android PLUGIN_VERSION
     CDVPluginResult *result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:version];
     [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@josuelmm/cordova-background-geolocation",
-  "version": "4.2.0",
+  "version": "4.2.2",
   "description": "Cordova Background Geolocation (fork actualizado)",
   "main": "./www/BackgroundGeolocation.js",
   "types": "./www/BackgroundGeolocation.d.ts",
@@ -99,6 +99,11 @@
         "cordova": ">=10.0.0",
         "cordova-android": ">=12.0.0",
         "cordova-ios": ">=6.2.0"
+      },
+      "4.2.2": {
+        "cordova": ">=10.0.0",
+        "cordova-android": ">=12.0.0",
+        "cordova-ios": ">=6.2.0"
       }
     }
   },

package/plugin.xml

@@ -2,7 +2,7 @@
 <plugin xmlns="http://www.phonegap.com/ns/plugins/1.0"
     xmlns:android="http://schemas.android.com/apk/res/android"
     id="cordova-background-geolocation"
-    version="4.2.0">
+    version="4.2.2">
     <name>cordova-background-geolocation</name>
     <description>Cordova Background Geolocation Plugin</description>
     <license>Apache-2.0</license>