Enhance heartbeat functionality to include GPS coordinates for improved session management

Author: MrAlders0n

lib/providers/app_state_provider.dart

@@ -1318,7 +1318,14 @@ class AppStateProvider extends ChangeNotifier {
       // Enable heartbeat if not in offline mode
       // Heartbeat fires after 3 minutes of API inactivity to keep session alive
       if (!_preferences.offlineMode) {
-        _apiService.enableHeartbeat();
+        _apiService.enableHeartbeat(
+          gpsProvider: () {
+            // Provide current GPS coordinates for heartbeat (matching wardrive.js)
+            final pos = _gpsService?.lastPosition;
+            if (pos == null) return null;
+            return (lat: pos.latitude, lon: pos.longitude);
+          },
+        );
       }
 
       // Start background service for continuous operation

lib/services/api_service.dart

@@ -38,6 +38,10 @@ class ApiService {
   Function? _onSessionExpiring;
   List<String> _channels = [];
 
+  /// Callback to get current GPS coordinates for heartbeat
+  /// Returns (lat, lon) or null if GPS is not available
+  ({double lat, double lon})? Function()? _gpsProvider;
+
   /// Regional channels from auth response (e.g., ['public', 'ottawa', 'testing'])
   List<String> get channels => List.unmodifiable(_channels);
 
@@ -271,15 +275,18 @@ class ApiService {
 
   /// Enable heartbeat mode (called when auto mode starts)
   /// Heartbeat fires after 3 minutes of API inactivity to keep session alive
-  void enableHeartbeat() {
+  /// @param gpsProvider Callback to get current GPS coordinates for heartbeat
+  void enableHeartbeat({({double lat, double lon})? Function()? gpsProvider}) {
     _heartbeatEnabled = true;
+    _gpsProvider = gpsProvider;
     _resetHeartbeatTimer();
     debugLog('[API] Heartbeat mode enabled (3 min idle timeout)');
   }
 
   /// Disable heartbeat mode (called when auto mode stops)
   void disableHeartbeat() {
     _heartbeatEnabled = false;
+    _gpsProvider = null;
     _heartbeatTimer?.cancel();
     _heartbeatTimer = null;
     debugLog('[API] Heartbeat mode disabled');
@@ -293,7 +300,11 @@ class ApiService {
     _heartbeatTimer?.cancel();
     _heartbeatTimer = Timer(heartbeatIdleTimeout, () async {
       debugLog('[API] Heartbeat timer fired (3 min idle), sending keepalive');
-      final result = await sendHeartbeat();
+
+      // Get GPS coordinates from provider (matching wardrive.js behavior)
+      final coords = _gpsProvider?.call();
+      final result = await sendHeartbeat(lat: coords?.lat, lon: coords?.lon);
+
       if (result?['success'] == true) {
         debugLog('[API] Heartbeat successful');
         _resetHeartbeatTimer();  // Schedule next heartbeat