@josuelmm/cordova-background-geolocation 3.1.1 → 4.2.0

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

@@ -21,6 +21,7 @@ import com.marianhello.bgloc.PluginDelegate;
 import com.marianhello.bgloc.PluginException;
 import com.marianhello.bgloc.cordova.ConfigMapper;
 import com.marianhello.bgloc.cordova.PluginRegistry;
+import com.marianhello.bgloc.oem.BatteryOemHelper;
 import com.marianhello.bgloc.cordova.headless.JsEvaluatorTaskRunner;
 import com.marianhello.bgloc.data.BackgroundActivity;
 import com.marianhello.bgloc.data.BackgroundLocation;
@@ -73,10 +74,22 @@ public class BackgroundGeolocationPlugin extends CordovaPlugin implements Plugin
     public static final String ACTION_FORCE_SYNC = "forceSync";
     public static final String ACTION_CLEAR_SYNC = "clearSync";
     public static final String ACTION_GET_PENDING_SYNC_COUNT = "getPendingSyncCount";
+    public static final String ACTION_START_SESSION = "startSession";
+    public static final String ACTION_GET_SESSION_LOCATIONS = "getSessionLocations";
+    public static final String ACTION_CLEAR_SESSION = "clearSession";
+    public static final String ACTION_GET_SESSION_LOCATIONS_COUNT = "getSessionLocationsCount";
     public static final String ACTION_GET_PLUGIN_VERSION = "getPluginVersion";
+    public static final String ACTION_GET_DIAGNOSTICS = "getDiagnostics";
+    // v3.6 Phase 5
+    public static final String ACTION_IS_IGNORING_BATTERY_OPT       = "isIgnoringBatteryOptimizations";
+    public static final String ACTION_REQUEST_IGNORE_BATTERY_OPT    = "requestIgnoreBatteryOptimizations";
+    public static final String ACTION_OPEN_BATTERY_SETTINGS         = "openBatterySettings";
+    public static final String ACTION_OPEN_AUTOSTART_SETTINGS       = "openAutoStartSettings";
+    public static final String ACTION_GET_MANUFACTURER_HELP         = "getManufacturerHelp";
+    public static final String ACTION_TRIGGER_SOS                   = "triggerSOS";
 
     /** Plugin version; keep in sync with plugin.xml. */
-    public static final String PLUGIN_VERSION = "3.1.0";
+    public static final String PLUGIN_VERSION = "4.2.0";
 
     private BackgroundGeolocationFacade facade;
 
@@ -399,14 +412,197 @@ public class BackgroundGeolocationPlugin extends CordovaPlugin implements Plugin
                 }
             });
             return true;
+        } else if (ACTION_START_SESSION.equals(action)) {
+            runOnWebViewThread(new Runnable() {
+                @Override
+                public void run() {
+                    facade.startSession();
+                    callbackContext.success();
+                }
+            });
+            return true;
+        } else if (ACTION_GET_SESSION_LOCATIONS.equals(action)) {
+            runOnWebViewThread(new Runnable() {
+                @Override
+                public void run() {
+                    try {
+                        callbackContext.success(getSessionLocations());
+                    } catch (JSONException e) {
+                        callbackContext.sendPluginResult(ErrorPluginResult.from("getSessionLocations failed", e, PluginException.JSON_ERROR));
+                    }
+                }
+            });
+            return true;
+        } else if (ACTION_CLEAR_SESSION.equals(action)) {
+            runOnWebViewThread(new Runnable() {
+                @Override
+                public void run() {
+                    facade.clearSession();
+                    callbackContext.success();
+                }
+            });
+            return true;
+        } else if (ACTION_GET_SESSION_LOCATIONS_COUNT.equals(action)) {
+            runOnWebViewThread(new Runnable() {
+                @Override
+                public void run() {
+                    try {
+                        int count = facade.getSessionLocationsCount();
+                        callbackContext.success(count);
+                    } catch (Exception e) {
+                        callbackContext.sendPluginResult(ErrorPluginResult.from("getSessionLocationsCount failed", e, PluginException.SERVICE_ERROR));
+                    }
+                }
+            });
+            return true;
         } else if (ACTION_GET_PLUGIN_VERSION.equals(action)) {
             callbackContext.success(PLUGIN_VERSION);
             return true;
+        } else if (ACTION_GET_DIAGNOSTICS.equals(action)) {
+            runOnWebViewThread(new Runnable() {
+                @Override
+                public void run() {
+                    try {
+                        callbackContext.success(buildDiagnostics());
+                    } catch (Exception e) {
+                        callbackContext.sendPluginResult(ErrorPluginResult.from("getDiagnostics failed", e, PluginException.SERVICE_ERROR));
+                    }
+                }
+            });
+            return true;
+        } else if (ACTION_IS_IGNORING_BATTERY_OPT.equals(action)) {
+            Context ctx = cordova.getActivity().getApplicationContext();
+            callbackContext.success(BatteryOemHelper.isIgnoringBatteryOptimizations(ctx) ? 1 : 0);
+            return true;
+        } else if (ACTION_REQUEST_IGNORE_BATTERY_OPT.equals(action)) {
+            BatteryOemHelper.requestIgnoreBatteryOptimizations(cordova.getActivity());
+            // Resolve with the (possibly unchanged) current state; the user accepts the dialog asynchronously.
+            Context ctx = cordova.getActivity().getApplicationContext();
+            callbackContext.success(BatteryOemHelper.isIgnoringBatteryOptimizations(ctx) ? 1 : 0);
+            return true;
+        } else if (ACTION_OPEN_BATTERY_SETTINGS.equals(action)) {
+            BatteryOemHelper.openBatterySettings(cordova.getActivity());
+            callbackContext.success();
+            return true;
+        } else if (ACTION_OPEN_AUTOSTART_SETTINGS.equals(action)) {
+            try {
+                callbackContext.success(BatteryOemHelper.openAutoStartSettings(cordova.getActivity()));
+            } catch (Exception e) {
+                callbackContext.sendPluginResult(ErrorPluginResult.from("openAutoStartSettings failed", e, PluginException.SERVICE_ERROR));
+            }
+            return true;
+        } else if (ACTION_GET_MANUFACTURER_HELP.equals(action)) {
+            try {
+                callbackContext.success(BatteryOemHelper.getManufacturerHelp());
+            } catch (Exception e) {
+                callbackContext.sendPluginResult(ErrorPluginResult.from("getManufacturerHelp failed", e, PluginException.SERVICE_ERROR));
+            }
+            return true;
+        } else if (ACTION_TRIGGER_SOS.equals(action)) {
+            try {
+                JSONObject payload = data.optJSONObject(0);
+                facade.triggerSOS(payload);
+                callbackContext.success();
+            } catch (Exception e) {
+                callbackContext.sendPluginResult(ErrorPluginResult.from("triggerSOS failed", e, PluginException.SERVICE_ERROR));
+            }
+            return true;
         }
 
         return false;
     }
 
+    /** v3.5 Phase 4: extended diagnostics. */
+    private JSONObject buildDiagnostics() throws JSONException {
+        JSONObject d = new JSONObject();
+        Context ctx = cordova.getActivity().getApplicationContext();
+
+        // Common
+        d.put("isRunning", facade.isRunning());
+        d.put("locationServicesEnabled", facade.locationServicesEnabled());
+
+        try {
+            Config cfg = facade.getConfig();
+            if (cfg != null) {
+                d.put("startOnBoot", cfg.getStartOnBoot());
+            }
+        } catch (Exception ignored) { /* config may not be persisted yet */ }
+
+        try {
+            d.put("pendingSyncCount", (int) Math.min(facade.getPendingSyncCount(), Integer.MAX_VALUE));
+        } catch (Exception ignored) { /* DAO might not be ready */ }
+
+        try {
+            BackgroundLocation last = facade.getStationaryLocation();
+            // Last *received* location is closer to lastBest; we expose stationary as a fallback signal.
+            d.put("lastLocationAt", last != null ? last.getTime() : JSONObject.NULL);
+        } catch (Exception ignored) {
+            d.put("lastLocationAt", JSONObject.NULL);
+        }
+
+        // Permissions
+        d.put("fineLocationGranted", hasPermission(ctx, android.Manifest.permission.ACCESS_FINE_LOCATION));
+        d.put("coarseLocationGranted", hasPermission(ctx, android.Manifest.permission.ACCESS_COARSE_LOCATION));
+        if (android.os.Build.VERSION.SDK_INT >= 29) {
+            d.put("backgroundLocationGranted", hasPermission(ctx, android.Manifest.permission.ACCESS_BACKGROUND_LOCATION));
+        } else {
+            d.put("backgroundLocationGranted", true);
+        }
+        if (android.os.Build.VERSION.SDK_INT >= 33) {
+            d.put("notificationPermissionGranted", hasPermission(ctx, "android.permission.POST_NOTIFICATIONS"));
+        } else {
+            d.put("notificationPermissionGranted", true);
+        }
+        if (android.os.Build.VERSION.SDK_INT >= 29) {
+            d.put("activityRecognitionGranted", hasPermission(ctx, "android.permission.ACTIVITY_RECOGNITION"));
+        } else {
+            d.put("activityRecognitionGranted", true);
+        }
+
+        // Battery / OEM
+        d.put("batteryOptimizationIgnored", isIgnoringBatteryOptimizations(ctx));
+        d.put("manufacturer", android.os.Build.MANUFACTURER != null ? android.os.Build.MANUFACTURER : "");
+
+        // Foreground service type read from manifest (only meaningful on API 34+; reported as-is otherwise)
+        d.put("foregroundServiceType", readForegroundServiceTypeFromManifest(ctx));
+
+        return d;
+    }
+
+    private static boolean hasPermission(Context ctx, String permission) {
+        try {
+            return ctx.getPackageManager().checkPermission(permission, ctx.getPackageName())
+                    == android.content.pm.PackageManager.PERMISSION_GRANTED;
+        } catch (Exception e) {
+            return false;
+        }
+    }
+
+    private static boolean isIgnoringBatteryOptimizations(Context ctx) {
+        if (android.os.Build.VERSION.SDK_INT < android.os.Build.VERSION_CODES.M) return true;
+        try {
+            android.os.PowerManager pm = (android.os.PowerManager) ctx.getSystemService(Context.POWER_SERVICE);
+            return pm != null && pm.isIgnoringBatteryOptimizations(ctx.getPackageName());
+        } catch (Exception e) {
+            return false;
+        }
+    }
+
+    private static int readForegroundServiceTypeFromManifest(Context ctx) {
+        if (android.os.Build.VERSION.SDK_INT < 34) return 0;
+        try {
+            android.content.ComponentName cn = new android.content.ComponentName(
+                    ctx, com.marianhello.bgloc.service.LocationServiceImpl.class);
+            android.content.pm.ServiceInfo si = ctx.getPackageManager().getServiceInfo(
+                    cn, android.content.pm.PackageManager.ComponentInfoFlags.of(0));
+            java.lang.reflect.Field f = android.content.pm.ServiceInfo.class.getField("foregroundServiceType");
+            Object v = f.get(si);
+            return (v instanceof Integer) ? (Integer) v : 0;
+        } catch (Throwable e) {
+            return 0;
+        }
+    }
+
     /**
      * Called when the system is about to start resuming a previous activity.
      *
@@ -557,6 +753,15 @@ public class BackgroundGeolocationPlugin extends CordovaPlugin implements Plugin
         return jsonLocationsArray;
     }
 
+    private JSONArray getSessionLocations() throws JSONException {
+        JSONArray jsonLocationsArray = new JSONArray();
+        Collection<BackgroundLocation> locations = facade.getSessionLocations();
+        for (BackgroundLocation location : locations) {
+            jsonLocationsArray.put(location.toJSONObjectWithId());
+        }
+        return jsonLocationsArray;
+    }
+
     private JSONArray getLogs(Integer limit, int offset, String minLevel) throws Exception {
         JSONArray jsonLogsArray = new JSONArray();
         Collection<LogEntry> logEntries = facade.getLogEntries(limit, offset, minLevel);
@@ -637,4 +842,160 @@ public class BackgroundGeolocationPlugin extends CordovaPlugin implements Plugin
     public void onError(PluginException e) {
         sendError(e);
     }
+
+    // v3.5 Phase 4: sync queue events
+    @Override
+    public void onSyncStart() {
+        sendEvent("syncStart");
+    }
+
+    @Override
+    public void onSyncSuccess(int locationsSent) {
+        try {
+            JSONObject payload = new JSONObject();
+            payload.put("sent", locationsSent);
+            sendEvent("syncSuccess", payload);
+        } catch (JSONException e) {
+            sendEvent("syncSuccess");
+        }
+    }
+
+    @Override
+    public void onSyncError(int httpStatus, String message) {
+        try {
+            JSONObject payload = new JSONObject();
+            payload.put("httpStatus", httpStatus);
+            payload.put("message", message != null ? message : "");
+            sendEvent("syncError", payload);
+        } catch (JSONException e) {
+            sendEvent("syncError");
+        }
+    }
+
+    @Override
+    public void onSyncProgress(int progress) {
+        sendEvent("syncProgress", Integer.valueOf(progress));
+    }
+
+    @Override
+    public void onHeartbeat(BackgroundLocation location) {
+        if (location == null) {
+            sendEvent("heartbeat");
+            return;
+        }
+        try {
+            sendEvent("heartbeat", location.toJSONObjectWithId());
+        } catch (JSONException e) {
+            sendEvent("heartbeat");
+        }
+    }
+
+    // v4.0 Phase 6 — driver-insight events
+    @Override
+    public void onTripStart(BackgroundLocation location) {
+        sendLocationEvent("tripStart", location);
+    }
+
+    @Override
+    public void onTripEnd(BackgroundLocation location, double distance, long durationMs) {
+        try {
+            JSONObject p = new JSONObject();
+            p.put("location", location != null ? location.toJSONObjectWithId() : JSONObject.NULL);
+            p.put("distance", distance);
+            p.put("durationMs", durationMs);
+            sendEvent("tripEnd", p);
+        } catch (JSONException e) { sendEvent("tripEnd"); }
+    }
+
+    @Override
+    public void onMoving(BackgroundLocation location) {
+        sendLocationEvent("moving", location);
+    }
+
+    @Override
+    public void onStopped(BackgroundLocation location) {
+        sendLocationEvent("stopped", location);
+    }
+
+    @Override
+    public void onSpeeding(BackgroundLocation location, double speedKmh, double limitKmh) {
+        try {
+            JSONObject p = new JSONObject();
+            p.put("location", location != null ? location.toJSONObjectWithId() : JSONObject.NULL);
+            p.put("speedKmh", speedKmh);
+            p.put("limitKmh", limitKmh);
+            sendEvent("speeding", p);
+        } catch (JSONException e) { sendEvent("speeding"); }
+    }
+
+    @Override
+    public void onProviderChange(String provider) {
+        try {
+            JSONObject p = new JSONObject();
+            p.put("provider", provider != null ? provider : "");
+            sendEvent("providerChange", p);
+        } catch (JSONException e) { sendEvent("providerChange"); }
+    }
+
+    @Override
+    public void onSOS(BackgroundLocation location, JSONObject userPayload) {
+        try {
+            JSONObject p = userPayload != null ? new JSONObject(userPayload.toString()) : new JSONObject();
+            p.put("location", location != null ? location.toJSONObjectWithId() : JSONObject.NULL);
+            sendEvent("sos", p);
+        } catch (JSONException e) { sendEvent("sos"); }
+    }
+
+    private void sendLocationEvent(String name, BackgroundLocation location) {
+        if (location == null) { sendEvent(name); return; }
+        try { sendEvent(name, location.toJSONObjectWithId()); }
+        catch (JSONException e) { sendEvent(name); }
+    }
+
+    // v4.1 GPS-derived sensor-like events
+    @Override
+    public void onHardBrake(BackgroundLocation location, double decelMps2) {
+        sendDrivingEvent("hardBrake", location, decelMps2);
+    }
+    @Override
+    public void onRapidAcceleration(BackgroundLocation location, double accelMps2) {
+        sendDrivingEvent("rapidAcceleration", location, accelMps2);
+    }
+    @Override
+    public void onSharpTurn(BackgroundLocation location, double degPerSec) {
+        sendDrivingEvent("sharpTurn", location, degPerSec);
+    }
+    @Override
+    public void onPossibleCrash(BackgroundLocation location, double velocityDropKmh) {
+        sendDrivingEvent("possibleCrash", location, velocityDropKmh);
+    }
+
+    // v4.2 sensor fusion: enriched possibleCrash with `source` ("gps"|"sensor") and phone-usage event.
+    @Override
+    public void onPossibleCrash(BackgroundLocation location, double value, String source) {
+        try {
+            JSONObject p = new JSONObject();
+            p.put("location", location != null ? location.toJSONObjectWithId() : JSONObject.NULL);
+            p.put("value", value);
+            p.put("source", source != null ? source : "gps");
+            sendEvent("possibleCrash", p);
+        } catch (JSONException e) {
+            sendEvent("possibleCrash");
+        }
+    }
+    @Override
+    public void onPhoneUsageWhileDriving(BackgroundLocation location) {
+        sendLocationEvent("phoneUsageWhileDriving", location);
+    }
+
+    private void sendDrivingEvent(String name, BackgroundLocation location, double value) {
+        try {
+            JSONObject p = new JSONObject();
+            p.put("location", location != null ? location.toJSONObjectWithId() : JSONObject.NULL);
+            p.put("value", value);
+            sendEvent(name, p);
+        } catch (JSONException e) {
+            sendEvent(name);
+        }
+    }
 }

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

@@ -26,11 +26,13 @@ import com.marianhello.bgloc.data.BackgroundLocation;
 import com.marianhello.bgloc.data.ConfigurationDAO;
 import com.marianhello.bgloc.data.DAOFactory;
 import com.marianhello.bgloc.data.LocationDAO;
+import com.marianhello.bgloc.data.SessionLocationDAO;
 import com.marianhello.bgloc.provider.LocationProvider;
 import com.marianhello.bgloc.service.LocationService;
 import com.marianhello.bgloc.service.LocationServiceImpl;
 import com.marianhello.bgloc.service.LocationServiceProxy;
 import com.marianhello.bgloc.data.LocationTransform;
+import com.marianhello.bgloc.data.sqlite.SQLiteSessionLocationDAO;
 import com.marianhello.bgloc.sync.AccountHelper;
 import com.marianhello.bgloc.sync.NotificationHelper;
 import com.marianhello.bgloc.sync.SyncService;
@@ -172,6 +174,117 @@ public class BackgroundGeolocationFacade {
 
                     return;
                 }
+
+                case LocationServiceImpl.MSG_ON_SYNC_START: {
+                    logger.debug("Received MSG_ON_SYNC_START");
+                    if (mDelegate != null) mDelegate.onSyncStart();
+                    return;
+                }
+
+                case LocationServiceImpl.MSG_ON_SYNC_SUCCESS: {
+                    int sent = bundle != null ? bundle.getInt("sent", 0) : 0;
+                    logger.debug("Received MSG_ON_SYNC_SUCCESS sent={}", sent);
+                    if (mDelegate != null) mDelegate.onSyncSuccess(sent);
+                    return;
+                }
+
+                case LocationServiceImpl.MSG_ON_SYNC_ERROR: {
+                    int status = bundle != null ? bundle.getInt("httpStatus", 0) : 0;
+                    String msg = bundle != null ? bundle.getString("message", "") : "";
+                    logger.debug("Received MSG_ON_SYNC_ERROR status={} message={}", status, msg);
+                    if (mDelegate != null) mDelegate.onSyncError(status, msg);
+                    return;
+                }
+
+                case LocationServiceImpl.MSG_ON_SYNC_PROGRESS: {
+                    int progress = bundle != null ? bundle.getInt("progress", 0) : 0;
+                    if (mDelegate != null) mDelegate.onSyncProgress(progress);
+                    return;
+                }
+
+                case LocationServiceImpl.MSG_ON_HEARTBEAT: {
+                    if (bundle != null) {
+                        bundle.setClassLoader(LocationServiceImpl.class.getClassLoader());
+                    }
+                    BackgroundLocation hb = bundle != null ? (BackgroundLocation) bundle.getParcelable("payload") : null;
+                    if (mDelegate != null) mDelegate.onHeartbeat(hb);
+                    return;
+                }
+
+                // v4.0 Phase 6: driver-insights events
+                case LocationServiceImpl.MSG_ON_TRIP_START:
+                case LocationServiceImpl.MSG_ON_TRIP_END:
+                case LocationServiceImpl.MSG_ON_MOVING:
+                case LocationServiceImpl.MSG_ON_STOPPED:
+                case LocationServiceImpl.MSG_ON_SPEEDING:
+                case LocationServiceImpl.MSG_ON_SOS: {
+                    if (bundle != null) bundle.setClassLoader(LocationServiceImpl.class.getClassLoader());
+                    BackgroundLocation loc = bundle != null ? (BackgroundLocation) bundle.getParcelable("payload") : null;
+                    if (mDelegate == null) return;
+                    switch (action) {
+                        case LocationServiceImpl.MSG_ON_TRIP_START:
+                            mDelegate.onTripStart(loc); break;
+                        case LocationServiceImpl.MSG_ON_TRIP_END:
+                            double dist = bundle != null ? bundle.getDouble("distance", 0.0) : 0.0;
+                            long durMs = bundle != null ? bundle.getLong("durationMs", 0L) : 0L;
+                            mDelegate.onTripEnd(loc, dist, durMs); break;
+                        case LocationServiceImpl.MSG_ON_MOVING:
+                            mDelegate.onMoving(loc); break;
+                        case LocationServiceImpl.MSG_ON_STOPPED:
+                            mDelegate.onStopped(loc); break;
+                        case LocationServiceImpl.MSG_ON_SPEEDING:
+                            double sKmh = bundle != null ? bundle.getDouble("speedKmh", 0.0) : 0.0;
+                            double lKmh = bundle != null ? bundle.getDouble("limitKmh", 0.0) : 0.0;
+                            mDelegate.onSpeeding(loc, sKmh, lKmh); break;
+                        case LocationServiceImpl.MSG_ON_SOS:
+                            org.json.JSONObject sosPayload = null;
+                            if (bundle != null) {
+                                String s = bundle.getString("sosPayload");
+                                if (s != null) {
+                                    try { sosPayload = new org.json.JSONObject(s); }
+                                    catch (org.json.JSONException ignored) { sosPayload = new org.json.JSONObject(); }
+                                }
+                            }
+                            mDelegate.onSOS(loc, sosPayload); break;
+                    }
+                    return;
+                }
+
+                case LocationServiceImpl.MSG_ON_PROVIDER_CHANGE: {
+                    String provider = bundle != null ? bundle.getString("provider", "") : "";
+                    if (mDelegate != null) mDelegate.onProviderChange(provider);
+                    return;
+                }
+
+                // v4.1 GPS-derived sensor-like events (and v4.2 sensor-driven possibleCrash)
+                case LocationServiceImpl.MSG_ON_HARD_BRAKE:
+                case LocationServiceImpl.MSG_ON_RAPID_ACCELERATION:
+                case LocationServiceImpl.MSG_ON_SHARP_TURN:
+                case LocationServiceImpl.MSG_ON_POSSIBLE_CRASH: {
+                    if (bundle != null) bundle.setClassLoader(LocationServiceImpl.class.getClassLoader());
+                    BackgroundLocation drvLoc = bundle != null ? (BackgroundLocation) bundle.getParcelable("payload") : null;
+                    double drvVal = bundle != null ? bundle.getDouble("value", 0.0) : 0.0;
+                    String drvSrc = bundle != null ? bundle.getString("source", "gps") : "gps";
+                    if (mDelegate == null) return;
+                    switch (action) {
+                        case LocationServiceImpl.MSG_ON_HARD_BRAKE:
+                            mDelegate.onHardBrake(drvLoc, drvVal); break;
+                        case LocationServiceImpl.MSG_ON_RAPID_ACCELERATION:
+                            mDelegate.onRapidAcceleration(drvLoc, drvVal); break;
+                        case LocationServiceImpl.MSG_ON_SHARP_TURN:
+                            mDelegate.onSharpTurn(drvLoc, drvVal); break;
+                        case LocationServiceImpl.MSG_ON_POSSIBLE_CRASH:
+                            mDelegate.onPossibleCrash(drvLoc, drvVal, drvSrc); break;
+                    }
+                    return;
+                }
+                // v4.2 sensor fusion: phone usage while driving
+                case LocationServiceImpl.MSG_ON_PHONE_USAGE_WHILE_DRIVING: {
+                    if (bundle != null) bundle.setClassLoader(LocationServiceImpl.class.getClassLoader());
+                    BackgroundLocation puLoc = bundle != null ? (BackgroundLocation) bundle.getParcelable("payload") : null;
+                    if (mDelegate != null) mDelegate.onPhoneUsageWhileDriving(puLoc);
+                    return;
+                }
             }
         }
     };
@@ -294,6 +407,30 @@ public class BackgroundGeolocationFacade {
         return dao.getValidLocationsAndDelete();
     }
 
+    /** Clear session table and start storing all new locations in session. Call when user starts a route. */
+    public void startSession() {
+        SessionLocationDAO dao = new SQLiteSessionLocationDAO(getContext());
+        dao.startSession();
+    }
+
+    /** Return all locations stored in the current session (ordered by time). */
+    public Collection<BackgroundLocation> getSessionLocations() {
+        SessionLocationDAO dao = new SQLiteSessionLocationDAO(getContext());
+        return dao.getSessionLocations();
+    }
+
+    /** Clear session table and stop storing. Call when route is finished and sync OK. */
+    public void clearSession() {
+        SessionLocationDAO dao = new SQLiteSessionLocationDAO(getContext());
+        dao.clearSession();
+    }
+
+    /** Number of locations in the current session. */
+    public int getSessionLocationsCount() {
+        SessionLocationDAO dao = new SQLiteSessionLocationDAO(getContext());
+        return dao.getSessionLocationsCount();
+    }
+
     public BackgroundLocation getStationaryLocation() {
         return mStationaryLocation;
     }
@@ -422,6 +559,22 @@ public class BackgroundGeolocationFacade {
         SyncService.sync(syncAccount, resolver.getAuthority(), true);
     }
 
+    /**
+     * v4.0 Phase 6 — Trigger an SOS event. The plugin emits a single `sos` JS event
+     * carrying the latest known location and the user-supplied JSON payload.
+     */
+    public void triggerSOS(org.json.JSONObject payload) {
+        Bundle b = new Bundle();
+        b.putInt("action", LocationServiceImpl.MSG_ON_SOS);
+        BackgroundLocation last = LocationServiceImpl.getLastReceivedLocation();
+        if (last != null) b.putParcelable("payload", last);
+        b.putString("sosPayload", payload != null ? payload.toString() : "{}");
+        Intent intent = new Intent(LocationServiceImpl.ACTION_BROADCAST);
+        intent.putExtras(b);
+        androidx.localbroadcastmanager.content.LocalBroadcastManager
+                .getInstance(getContext().getApplicationContext()).sendBroadcast(intent);
+    }
+
     /**
      * Returns the number of locations pending to be synced (not yet sent to syncUrl).
      */

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

@@ -31,7 +31,8 @@ public class BootCompletedReceiver extends BroadcastReceiver {
 
     @Override
      public void onReceive(Context context, Intent intent) {
-        Log.d(TAG, "Received boot completed");
+        String action = intent != null ? intent.getAction() : null;
+        Log.d(TAG, "Received boot/replace broadcast: " + action);
         ConfigurationDAO dao = DAOFactory.createConfigurationDAO(context);
         Config config = null;
 
@@ -43,23 +44,34 @@ public class BootCompletedReceiver extends BroadcastReceiver {
 
         if (config == null) { return; }
 
-        Log.d(TAG, "Boot completed " + config.toString());
+        Log.d(TAG, "Boot/replace handler " + config.toString());
 
-        if (config.getStartOnBoot()) {
-            if (!hasLocationPermission(context)) {
-                Log.w(TAG, "Skipping start on boot: ACCESS_FINE_LOCATION or ACCESS_COARSE_LOCATION not granted");
-                return;
-            }
-            Log.i(TAG, "Starting service after boot");
-            Intent locationServiceIntent = new Intent(context, LocationServiceImpl.class);
-            locationServiceIntent.addFlags(Intent.FLAG_FROM_BACKGROUND);
-            locationServiceIntent.putExtra("config", config);
+        if (!config.getStartOnBoot()) { return; }
+
+        if (!hasLocationPermission(context)) {
+            Log.w(TAG, "Skipping start on boot: ACCESS_FINE_LOCATION or ACCESS_COARSE_LOCATION not granted");
+            return;
+        }
+        if (Build.VERSION.SDK_INT >= 29 && !hasBackgroundLocationPermission(context)) {
+            Log.w(TAG, "Skipping start on boot: ACCESS_BACKGROUND_LOCATION not granted (Android 10+)");
+            return;
+        }
 
+        Log.i(TAG, "Starting service after boot/replace");
+        Intent locationServiceIntent = new Intent(context, LocationServiceImpl.class);
+        locationServiceIntent.addFlags(Intent.FLAG_FROM_BACKGROUND);
+        locationServiceIntent.putExtra("config", config);
+
+        try {
             if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
                 context.startForegroundService(locationServiceIntent);
             } else {
                 context.startService(locationServiceIntent);
             }
+        } catch (Exception e) {
+            // Android 12+ may throw ForegroundServiceStartNotAllowedException.
+            // Log and exit; do NOT fall back to a non-foreground service for tracking.
+            Log.e(TAG, "Start on boot blocked: " + e.getClass().getSimpleName() + ": " + e.getMessage(), e);
         }
      }
 
@@ -67,4 +79,8 @@ public class BootCompletedReceiver extends BroadcastReceiver {
         return context.checkSelfPermission(Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED
                 || context.checkSelfPermission(Manifest.permission.ACCESS_COARSE_LOCATION) == PackageManager.PERMISSION_GRANTED;
     }
+
+    private static boolean hasBackgroundLocationPermission(Context context) {
+        return context.checkSelfPermission(Manifest.permission.ACCESS_BACKGROUND_LOCATION) == PackageManager.PERMISSION_GRANTED;
+    }
 }