@josuelmm/cordova-background-geolocation 4.2.0 → 4.2.3

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [4.2.3](https://github.com/josuelmm/cordova-background-geolocation/tree/4.2.3) (2026-05-09)
+
+### Fixed
+- `PostLocationTask`: log de debug pasaba 3 args para 4 placeholders `{}` (faltaba `mode`). Cosmético, sin impacto funcional.
+
+### Audited (no changes required)
+- HTTP transport (real-time + sync queue) intacto: URL templating, `httpMethod`/`httpMode`/`syncMode`, headers, `Content-Length` UTF-8.
+- Hot-reload `configure()` de v4.2 no toca `clearQueue` — no se pierden ubicaciones pendientes.
+- Sensor fusion: imports, protocolo iOS, MSG codes, parcels simétricos, listeners enlazados — sin regresiones.
+
+## [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,19 @@
 
 **for cordova-plugin-background-geolocation**
 
+## [4.2.3] - 2026-05-09
+
+### Fixed
+- `PostLocationTask` debug log: missing `mode` argument for the 4-placeholder format string. Cosmetic.
+- Plugin version: `4.2.3`.
+
+## [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.3";
 
     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) {
@@ -192,7 +195,11 @@ public class PostLocationTask {
         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.3"; // 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.3",
   "description": "Cordova Background Geolocation (fork actualizado)",
   "main": "./www/BackgroundGeolocation.js",
   "types": "./www/BackgroundGeolocation.d.ts",
@@ -99,6 +99,16 @@
         "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"
+      },
+      "4.2.3": {
+        "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.3">
     <name>cordova-background-geolocation</name>
     <description>Cordova Background Geolocation Plugin</description>
     <license>Apache-2.0</license>