@josuelmm/cordova-background-geolocation 4.5.4 → 4.5.5

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [4.5.5](https://github.com/josuelmm/cordova-background-geolocation/tree/4.5.5) (2026-06-05)
+
+### Added — `@time_seconds` placeholder
+- Nuevo placeholder `@time_seconds` que resuelve al UTC Unix epoch en **segundos** (10 dígitos), no en milisegundos.
+- **Motivación**: Traccar (protocolo OsmAnd) y varios decoders parsean `timestamp` como segundos. Cuando reciben 13 dígitos (milisegundos) lo intentan parsear como año-58390, lo descartan silenciosamente y **caen al server time**. Sin esto, locations sincronizadas offline llegaban con timestamp del momento del sync en lugar del momento del fix GPS — el path en el mapa parecía "comprimido" porque todos los records compartían hora.
+- **Uso para Traccar**:
+  ```js
+  postTemplate: {
+    lat: '@latitude',
+    lon: '@longitude',
+    timestamp: '@time_seconds',   // ← en lugar de @time
+    speed: '@speed',
+    accuracy: '@accuracy'
+  }
+  ```
+- Backends que quieren ISO 8601 pueden usar `@timestamp_iso` (ya existía).
+- Backends que esperan ms (genéricos JSON, Firebase) siguen con `@time`.
+
 ## [4.5.4](https://github.com/josuelmm/cordova-background-geolocation/tree/4.5.4) (2026-05-13)
 
 ### Fixed (BLOQUEANTE — sync HTTP 400 con servidores tipo Traccar)

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

@@ -96,7 +96,7 @@ public class BackgroundGeolocationPlugin extends CordovaPlugin implements Plugin
     public static final String ACTION_REQUEST_NOTIFICATION_PERMISSION = "requestNotificationPermission";
 
     /** Plugin version; keep in sync with plugin.xml. */
-    public static final String PLUGIN_VERSION = "4.5.4";
+    public static final String PLUGIN_VERSION = "4.5.5";
 
     private BackgroundGeolocationFacade facade;
 

package/android/common/src/main/java/com/marianhello/bgloc/data/BackgroundLocation.java

@@ -1041,6 +1041,13 @@ public class BackgroundLocation implements Parcelable {
         if ("@time".equals(key)) {
             return time;
         }
+        // v4.5.4 — Unix epoch in SECONDS (not ms). Useful for Traccar OsmAnd
+        // protocol and other backends whose decoders treat 13-digit values as
+        // year-58390 garbage and silently fall back to server time, dropping the
+        // real GPS fix time.
+        if ("@time_seconds".equals(key)) {
+            return time > 0 ? (time / 1000L) : JSONObject.NULL;
+        }
         if ("@latitude".equals(key)) {
             return latitude;
         }

package/ios/CDVBackgroundGeolocation/CDVBackgroundGeolocation.m

@@ -535,7 +535,7 @@ static NSString * const TAG = @"CDVBackgroundGeolocation";
 - (void) getPluginVersion:(CDVInvokedUrlCommand*)command
 {
     NSLog(@"%@ #%@", TAG, @"getPluginVersion");
-    NSString *version = @"4.5.4"; // keep in sync with plugin.xml and Android PLUGIN_VERSION
+    NSString *version = @"4.5.5"; // 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/ios/common/BackgroundGeolocation/MAURLocation.m

@@ -205,6 +205,13 @@ enum {
     if ([key isEqualToString:@"@time"]) {
         return [NSNumber numberWithDouble:([time timeIntervalSince1970] * 1000)];
     }
+    // v4.5.4 — Unix epoch in SECONDS (not ms). Useful for Traccar OsmAnd
+    // protocol and backends that treat 13-digit millis as garbage and silently
+    // fall back to server time, dropping the real GPS fix time.
+    if ([key isEqualToString:@"@time_seconds"]) {
+        if (time == nil) return [NSNull null];
+        return [NSNumber numberWithLongLong:(long long)[time timeIntervalSince1970]];
+    }
     if ([key isEqualToString:@"@accuracy"]) {
         return accuracy;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@josuelmm/cordova-background-geolocation",
-  "version": "4.5.4",
+  "version": "4.5.5",
   "description": "Cordova Background Geolocation (fork actualizado)",
   "main": "./www/BackgroundGeolocation.js",
   "types": "./www/BackgroundGeolocation.d.ts",

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.5.4">
+    version="4.5.5">
     <name>cordova-background-geolocation</name>
     <description>Cordova Background Geolocation Plugin</description>
     <license>Apache-2.0</license>