@josuelmm/cordova-background-geolocation 3.1.0 → 3.1.1

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## [3.1.1](https://github.com/josuelmm/cordova-background-geolocation/tree/3.1.1) (2026-02-27)
+
+### Added
+
+- **Browser / `ng serve` support** — The plugin uses `cordova/exec` and `cordova/channel`, which only exist in the Cordova runtime. To allow Angular (and other webpack-based) builds to succeed when running `ng serve` or building for browser, the package now ships:
+  - **Stub modules:** `www/cordova-exec-stub.js` and `www/cordova-channel-stub.js`. When running in the browser they avoid crashes; when running inside Cordova they delegate to the real `cordova.exec` and `cordova/channel`.
+  - **`browser` field in `package.json`** so bundlers (e.g. webpack) resolve `cordova/exec` and `cordova/channel` to these stubs. No app-side webpack config is required in normal setups.
+
+### Fixed
+
+- **Angular types on Windows** — The emitted `.d.ts` in `angular/dist/` used `from '../www/BackgroundGeolocation'`, which resolves (relative to `dist/`) to `angular/www/`, a folder that does not exist in the published package. Some apps worked around this by creating a junction `angular/www` → `www`. The build now runs a post-step (`scripts/fix-angular-dts-paths.js`) that rewrites these paths to `../../www/BackgroundGeolocation` in the emitted declarations, so types resolve to the package root `www/` and the junction is no longer needed.
+
+### Documentation
+
+- **docs/angular.md** — New section *"Build (ng serve / browser)"*: explains why the stubs exist, that webpack uses the `browser` field, and how to add resolve aliases in the app if a bundler does not respect it (e.g. "Can't resolve 'cordova/exec'"). Note that from 3.1.1 the junction workaround for types is unnecessary.
+
+- **README.md** — Angular section and "New in" updated to mention 3.1.1 and browser/ng serve compatibility.
+
+### Changed
+
+- Version bump to 3.1.1.
+
+[Full Changelog](https://github.com/josuelmm/cordova-background-geolocation/compare/3.1.0...3.1.1)
+
+---
+
 ## [3.1.0](https://github.com/josuelmm/cordova-background-geolocation/tree/3.1.0) (2026-02-21)
 
 ### Added

package/README.md

@@ -95,6 +95,22 @@ If your app’s merged manifest ends up with a `foregroundServiceType` other tha
 <string name="plugin_bgloc_content_authority">site.seelight.client.bgloc</string>
 ```
 
+**Notification labels (showTime / showDistance):** If you use `showTime: true` or `showDistance: true`, the notification shows a line for elapsed time and one for distance. **By default the labels are in English** ("Time" and "Distance"). If you want Spanish or another language, add these optional strings in your app so the plugin uses them; if you don’t define them, English is used.
+
+Example — English (default, optional in `res/values/strings.xml`):
+
+```xml
+<string name="plugin_bgloc_notification_time_label">Time</string>
+<string name="plugin_bgloc_notification_distance_label">Distance</string>
+```
+
+Example — Spanish: add in `res/values-es/strings.xml` (or your locale folder):
+
+```xml
+<string name="plugin_bgloc_notification_time_label">Tiempo</string>
+<string name="plugin_bgloc_notification_distance_label">Distancia</string>
+```
+
 This makes your app enforce the correct foreground service type and defines the strings the plugin needs for the sync account.
 
 ---
@@ -252,7 +268,18 @@ BackgroundGeolocation.stop();
 
 ### 5. Sync queue (syncUrl): pending count, force sync, clear queue
 
-When you use `syncUrl`, locations that fail to post to `url` (or that are only queued for sync) are sent in batch to `syncUrl`. You can:
+When you use `syncUrl`, locations that fail to post to `url` (or that are only queued for sync) are sent in batch to `syncUrl`.
+
+**How sync sends data (Content-Type):** It depends on the `Content-Type` you set in `httpHeaders`. Many people assume “one request per location”; that is only true for form encoding.
+
+| Content-Type | Sync to `syncUrl` |
+|--------------|-------------------|
+| **`application/json`** (default) | **One POST** with a JSON **array** of all locations in the batch. |
+| **`application/x-www-form-urlencoded`** | **One POST per location** (same flat `key=value&...` as real-time to `url`). Same endpoint can handle both. |
+
+So: with **JSON** you get one request per batch (e.g. 100 locations in one body). With **form-urlencoded** you get one request per location (one record per POST). For headers, retries, `postTemplate` and full behaviour see [HTTP posting](docs/http_posting.md) and [API](docs/api.md).
+
+You can:
 
 - **Get pending count** — `getPendingSyncCount()` returns how many locations are waiting to be synced.
 - **Force sync now** — `forceSync()` sends all pending locations immediately (ignores `syncThreshold`). No-op if `sync: false`.
@@ -277,6 +304,8 @@ BackgroundGeolocation.clearSync().then(function () {
 });
 ```
 
+More on sync (headers, retries, postTemplate): [HTTP posting](docs/http_posting.md). Full options and methods: [API](docs/api.md).
+
 ### 6. Other methods (summary)
 
 | Method | Description |
@@ -287,7 +316,7 @@ BackgroundGeolocation.clearSync().then(function () {
 | `deleteLocation(id, success, fail)` | Delete one location by id. |
 | `deleteAllLocations(success, fail)` | Delete all stored locations. |
 | `getCurrentLocation(success, fail, options)` | One-shot location (e.g. timeout, maximumAge). |
-| `getPluginVersion(success, fail)` | Plugin version string (e.g. "3.1.0"). |
+| `getPluginVersion(success, fail)` | Plugin version string (e.g. "3.1.1"). |
 | `checkStatus(success, fail)` | Service status (isRunning, authorization, etc.). |
 | `showAppSettings()` / `openSettings()` | Open app settings. |
 | `showLocationSettings()` | Open system location settings. |
@@ -314,6 +343,10 @@ 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 3.1.1
+
+- **Browser / `ng serve` builds** — The plugin can now be bundled by webpack without "Can't resolve 'cordova/exec'" or "Can't resolve 'cordova/channel'". The package ships stub modules and a `browser` field so `ng serve` and browser builds succeed; on device/emulator the stubs delegate to the real Cordova API. See [docs/angular.md](docs/angular.md#build-ng-serve--browser).
+
 ### New in 3.1.0
 
 - **`getPendingSyncCount()`** — Number of locations pending to be synced. Use with `forceSync()` for “X pending” UI.
@@ -370,6 +403,10 @@ export class MyService {
 
 **You must import `BackgroundGeolocationModule`** in your `AppModule` (or feature module) so the service is provided and AOT builds work. Then inject `BackgroundGeolocationService` as in the example above. See [docs/angular.md](docs/angular.md) for the full snippet.
 
+**`ng serve` / browser:** From 3.1.1 the plugin includes browser stubs so `ng serve` and web builds complete without "Can't resolve 'cordova/exec'" — see [docs/angular.md](docs/angular.md#build-ng-serve--browser).
+
+**Lazy-loaded pages:** If you see **NG0202** or *"dependency at index N is invalid"* when opening a page that injects this service, use an app-defined token and inject by that token (the plugin token can be undefined in the lazy chunk). See [docs/angular.md](docs/angular.md) (Lazy-loaded modules).
+
 **Migrating from @awesome-cordova-plugins/background-geolocation:** there you inject a class named `BackgroundGeolocation`. In this package, `BackgroundGeolocation` is the **global plugin object**, not an injectable class. Use `BackgroundGeolocationService` instead (same API). See [docs/angular.md](docs/angular.md) for details.
 
 ### Summary
@@ -394,13 +431,16 @@ No extra wrapper (e.g. Awesome Cordova Plugins) is required.
 
 ## Documentation and changelog
 
-- **[Documentation](https://josuelmm.github.io/cordova-background-geolocation/)** — Full docs (API, options, examples).
-- **[API reference](docs/api.md)** — All `configure` options, every method (`configure`, `start`, `stop`, `getPendingSyncCount`, `forceSync`, `clearSync`, `getConfig`, `getLocations`, etc.), TypeScript types.
-- **[HTTP posting](docs/http_posting.md)** — `url` vs `syncUrl`, headers, Content-Type (JSON vs form-urlencoded), sync batch behaviour, `getPendingSyncCount` / `forceSync` / `clearSync`.
-- **[Events](docs/events.md)** — All events (`location`, `error`, `stationary`, `activity`, `http_authorization`, etc.) and payloads.
-- **[Angular / Ionic](docs/angular.md)** — Injectable service, module, same API.
-- **[Example](docs/example.md)** — Full example with events and sync.
-- **[CHANGELOG](CHANGELOG.md)** — Version history.
+This README is the main entry point. For more detail, edge cases and examples use the docs below (and the [online documentation](https://josuelmm.github.io/cordova-background-geolocation/)).
+
+| Doc | What you’ll find |
+|-----|------------------|
+| **[API reference](docs/api.md)** | Every `configure` option, every method (`configure`, `start`, `stop`, `getPendingSyncCount`, `forceSync`, `clearSync`, `getConfig`, `getLocations`, etc.), TypeScript types. |
+| **[HTTP posting](docs/http_posting.md)** | `url` vs `syncUrl`, Content-Type (JSON = one POST with array; form-urlencoded = one POST per location), headers, retries, `postTemplate`, sync behaviour. |
+| **[Events](docs/events.md)** | All events (`location`, `error`, `stationary`, `activity`, `http_authorization`, etc.) and payloads. |
+| **[Angular / Ionic](docs/angular.md)** | Injectable service, module, lazy-loaded modules and token “must be defined”, `ng serve` / browser build. |
+| **[Example](docs/example.md)** | Full example with events and sync. |
+| **[CHANGELOG](CHANGELOG.md)** | Version history. |
 
 This project is based on [@mauron85/cordova-plugin-background-geolocation](https://github.com/mauron85/cordova-plugin-background-geolocation) and the original by [christocracy](https://github.com/christocracy). Maintained at [josuelmm/cordova-background-geolocation](https://github.com/josuelmm/cordova-background-geolocation). Issues and PRs welcome.
 

package/RELEASE.MD

@@ -1,5 +1,16 @@
 In order to release a version the following actions are needed:
-1. Update the version in the package.json, lock and plugin.xml files
-2. Go to [releases and create a new release](https://github.com/josuelmm/cordova-background-geolocation/releases/new) in GitHub
-3. Make sure to create a tag too with the version name (e.g. v3.1.0)
-4. Click create. Github actions will publish the package to npm
+
+1. **Version and docs**
+   - Set the new version (e.g. `3.1.1`) in:
+     - `package.json` (`version` field)
+     - `plugin.xml` (root `<plugin>` attribute `version`)
+   - Add a release entry in `CHANGELOG.md` (date, Added/Fixed/Changed/Documentation).
+   - Update `README.md` if needed (e.g. "New in X.Y.Z", example version strings).
+
+2. **Lock file**
+   - Run `npm install` so `package-lock.json` stays in sync with `package.json`.
+
+3. **Git tag and release**
+   - Go to [Releases → Create a new release](https://github.com/josuelmm/cordova-background-geolocation/releases/new).
+   - Create a tag with the version name (e.g. `v3.1.1`).
+   - Publish the release. GitHub Actions will publish the package to npm.

package/android/CDVBackgroundGeolocation/src/main/java/com/marianhello/bgloc/cordova/ConfigMapper.java

@@ -116,6 +116,12 @@ public class ConfigMapper {
         if (jObject.has("enableWatchdog")) {
             config.setEnableWatchdog(jObject.getBoolean("enableWatchdog"));
         }
+        if (jObject.has("showTime")) {
+            config.setShowTime(jObject.getBoolean("showTime"));
+        }
+        if (jObject.has("showDistance")) {
+            config.setShowDistance(jObject.getBoolean("showDistance"));
+        }
 
         return config;
     }
@@ -151,6 +157,8 @@ public class ConfigMapper {
         json.put("httpHeaders", new JSONObject(config.getHttpHeaders()));
         json.put("maxLocations", config.getMaxLocations());
         json.put("enableWatchdog", Boolean.TRUE.equals(config.getEnableWatchdog()));
+        json.put("showTime", Boolean.TRUE.equals(config.getShowTime()));
+        json.put("showDistance", Boolean.TRUE.equals(config.getShowDistance()));
         LocationTemplate tpl = config.getTemplate();
         Object template = JSONObject.NULL;
         if (tpl instanceof HashMapLocationTemplate) {

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

@@ -69,6 +69,8 @@ public class Config implements Parcelable
     private Integer maxLocations;
     private LocationTemplate template;
     private Boolean enableWatchdog;
+    private Boolean showTime;
+    private Boolean showDistance;
 
     public Config () {
     }
@@ -104,6 +106,8 @@ public class Config implements Parcelable
         this.httpHeaders = CloneHelper.deepCopy(config.httpHeaders);
         this.maxLocations = config.maxLocations;
         this.enableWatchdog = config.enableWatchdog;
+        this.showTime = config.showTime;
+        this.showDistance = config.showDistance;
         if (config.template instanceof AbstractLocationTemplate) {
             this.template = ((AbstractLocationTemplate)config.template).clone();
         }
@@ -138,6 +142,8 @@ public class Config implements Parcelable
         setSyncEnabled((Boolean) in.readValue(null));
         setMaxLocations(in.readInt());
         setEnableWatchdog((Boolean) in.readValue(null));
+        setShowTime((Boolean) in.readValue(null));
+        setShowDistance((Boolean) in.readValue(null));
         Bundle bundle = in.readBundle();
         setHttpHeaders((HashMap<String, String>) bundle.getSerializable("httpHeaders"));
         setTemplate((LocationTemplate) bundle.getSerializable(AbstractLocationTemplate.BUNDLE_KEY));
@@ -175,6 +181,8 @@ public class Config implements Parcelable
         config.maxLocations = 10000;
         config.template = null;
         config.enableWatchdog = false;
+        config.showTime = false;
+        config.showDistance = false;
 
         return config;
     }
@@ -213,6 +221,8 @@ public class Config implements Parcelable
         out.writeValue(getSyncEnabled());
         out.writeInt(getMaxLocations());
         out.writeValue(getEnableWatchdog());
+        out.writeValue(getShowTime());
+        out.writeValue(getShowDistance());
         Bundle bundle = new Bundle();
         bundle.putSerializable("httpHeaders", getHttpHeaders());
         bundle.putSerializable(AbstractLocationTemplate.BUNDLE_KEY, (AbstractLocationTemplate) getTemplate());
@@ -609,6 +619,32 @@ public class Config implements Parcelable
         this.enableWatchdog = enableWatchdog;
     }
 
+    public boolean hasShowTime() {
+        return showTime != null;
+    }
+
+    @Nullable
+    public Boolean getShowTime() {
+        return showTime;
+    }
+
+    public void setShowTime(Boolean showTime) {
+        this.showTime = showTime;
+    }
+
+    public boolean hasShowDistance() {
+        return showDistance != null;
+    }
+
+    @Nullable
+    public Boolean getShowDistance() {
+        return showDistance;
+    }
+
+    public void setShowDistance(Boolean showDistance) {
+        this.showDistance = showDistance;
+    }
+
     @Override
     public String toString () {
         return new StringBuffer()
@@ -637,6 +673,8 @@ public class Config implements Parcelable
                 .append(" httpHeaders=").append(getHttpHeaders().toString())
                 .append(" maxLocations=").append(getMaxLocations())
                 .append(" postTemplate=").append(hasTemplate() ? getTemplate().toString() : null)
+                .append(" showTime=").append(getShowTime())
+                .append(" showDistance=").append(getShowDistance())
                 .append("]")
                 .toString();
     }
@@ -744,6 +782,12 @@ public class Config implements Parcelable
         if (config2.hasTemplate()) {
             merger.setTemplate(config2.getTemplate());
         }
+        if (config2.hasShowTime()) {
+            merger.setShowTime(config2.getShowTime());
+        }
+        if (config2.hasShowDistance()) {
+            merger.setShowDistance(config2.getShowDistance());
+        }
 
         return merger;
     }

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

@@ -45,6 +45,8 @@ public final class SQLiteConfigurationContract {
         public static final String COLUMN_NAME_HEADERS = "http_headers";
         public static final String COLUMN_NAME_MAX_LOCATIONS = "max_locations";
         public static final String COLUMN_NAME_TEMPLATE = "template";
+        public static final String COLUMN_NAME_SHOW_TIME = "show_time";
+        public static final String COLUMN_NAME_SHOW_DISTANCE = "show_distance";
 
         public static final String SQL_CREATE_CONFIG_TABLE =
                 "CREATE TABLE " + ConfigurationEntry.TABLE_NAME + " (" +
@@ -77,7 +79,9 @@ public final class SQLiteConfigurationContract {
                         ConfigurationEntry.COLUMN_NAME_SYNC_ENABLED + INTEGER_TYPE + COMMA_SEP +
                         ConfigurationEntry.COLUMN_NAME_HEADERS + TEXT_TYPE + COMMA_SEP +
                         ConfigurationEntry.COLUMN_NAME_MAX_LOCATIONS + INTEGER_TYPE + COMMA_SEP +
-                        ConfigurationEntry.COLUMN_NAME_TEMPLATE + TEXT_TYPE +
+                        ConfigurationEntry.COLUMN_NAME_TEMPLATE + TEXT_TYPE + COMMA_SEP +
+                        ConfigurationEntry.COLUMN_NAME_SHOW_TIME + INTEGER_TYPE + COMMA_SEP +
+                        ConfigurationEntry.COLUMN_NAME_SHOW_DISTANCE + INTEGER_TYPE +
                         " )";
 
         public static final String SQL_DROP_CONFIG_TABLE =

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

@@ -61,7 +61,9 @@ public class SQLiteConfigurationDAO implements ConfigurationDAO {
       ConfigurationEntry.COLUMN_NAME_SYNC_ENABLED,
       ConfigurationEntry.COLUMN_NAME_HEADERS,
       ConfigurationEntry.COLUMN_NAME_MAX_LOCATIONS,
-      ConfigurationEntry.COLUMN_NAME_TEMPLATE
+      ConfigurationEntry.COLUMN_NAME_TEMPLATE,
+      ConfigurationEntry.COLUMN_NAME_SHOW_TIME,
+      ConfigurationEntry.COLUMN_NAME_SHOW_DISTANCE
     };
 
     String whereClause = null;
@@ -142,6 +144,14 @@ public class SQLiteConfigurationDAO implements ConfigurationDAO {
     config.setHttpHeaders(new JSONObject(c.getString(c.getColumnIndex(ConfigurationEntry.COLUMN_NAME_HEADERS))));
     config.setMaxLocations(c.getInt(c.getColumnIndex(ConfigurationEntry.COLUMN_NAME_MAX_LOCATIONS)));
     config.setTemplate(LocationTemplateFactory.fromJSONString(c.getString(c.getColumnIndex(ConfigurationEntry.COLUMN_NAME_TEMPLATE))));
+    int idxShowTime = c.getColumnIndex(ConfigurationEntry.COLUMN_NAME_SHOW_TIME);
+    if (idxShowTime >= 0 && !c.isNull(idxShowTime)) {
+      config.setShowTime(c.getInt(idxShowTime) == 1);
+    }
+    int idxShowDistance = c.getColumnIndex(ConfigurationEntry.COLUMN_NAME_SHOW_DISTANCE);
+    if (idxShowDistance >= 0 && !c.isNull(idxShowDistance)) {
+      config.setShowDistance(c.getInt(idxShowDistance) == 1);
+    }
 
     return config;
   }
@@ -178,6 +188,8 @@ public class SQLiteConfigurationDAO implements ConfigurationDAO {
     values.put(ConfigurationEntry.COLUMN_NAME_HEADERS, new JSONObject(config.getHttpHeaders()).toString());
     values.put(ConfigurationEntry.COLUMN_NAME_MAX_LOCATIONS, config.getMaxLocations());
     values.put(ConfigurationEntry.COLUMN_NAME_TEMPLATE, config.hasTemplate() ? config.getTemplate().toString() : null);
+    values.put(ConfigurationEntry.COLUMN_NAME_SHOW_TIME, Boolean.TRUE.equals(config.getShowTime()) ? 1 : 0);
+    values.put(ConfigurationEntry.COLUMN_NAME_SHOW_DISTANCE, Boolean.TRUE.equals(config.getShowDistance()) ? 1 : 0);
 
     return values;
   }

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

@@ -21,7 +21,7 @@ import static com.marianhello.bgloc.data.sqlite.SQLiteLocationContract.LocationE
 public class SQLiteOpenHelper extends android.database.sqlite.SQLiteOpenHelper {
     private static final String TAG = SQLiteOpenHelper.class.getName();
     public static final String SQLITE_DATABASE_NAME = "cordova_bg_geolocation.db";
-    public static final int DATABASE_VERSION = 18;
+    public static final int DATABASE_VERSION = 19;
 
     public static final String TEXT_TYPE = " TEXT";
     public static final String INTEGER_TYPE = " INTEGER";
@@ -132,6 +132,11 @@ public class SQLiteOpenHelper extends android.database.sqlite.SQLiteOpenHelper {
             case 17:
                 alterSql.add("ALTER TABLE " + ConfigurationEntry.TABLE_NAME +
                         " ADD COLUMN " + ConfigurationEntry.COLUMN_NAME_SYNC_ENABLED + INTEGER_TYPE);
+            case 18:
+                alterSql.add("ALTER TABLE " + ConfigurationEntry.TABLE_NAME +
+                        " ADD COLUMN " + ConfigurationEntry.COLUMN_NAME_SHOW_TIME + INTEGER_TYPE);
+                alterSql.add("ALTER TABLE " + ConfigurationEntry.TABLE_NAME +
+                        " ADD COLUMN " + ConfigurationEntry.COLUMN_NAME_SHOW_DISTANCE + INTEGER_TYPE);
 
                 break; // DO NOT FORGET TO MOVE DOWN BREAK ON DB UPGRADE!!!
             default:

package/android/common/src/main/java/com/marianhello/bgloc/service/LocationServiceImpl.java

@@ -22,6 +22,7 @@ import android.content.ComponentName;
 import android.content.pm.PackageManager;
 import android.content.pm.ServiceInfo;
 import android.Manifest;
+import android.location.Location;
 import android.net.ConnectivityManager;
 import android.net.NetworkInfo;
 import android.os.Binder;
@@ -67,6 +68,8 @@ import com.marianhello.logging.UncaughtExceptionLogger;
 import org.chromium.content.browser.ThreadUtils;
 import org.json.JSONException;
 
+import java.util.Locale;
+
 import static com.marianhello.bgloc.service.LocationServiceIntentBuilder.containsCommand;
 import static com.marianhello.bgloc.service.LocationServiceIntentBuilder.containsMessage;
 import static com.marianhello.bgloc.service.LocationServiceIntentBuilder.getCommand;
@@ -156,6 +159,30 @@ public class LocationServiceImpl extends Service implements ProviderDelegate, Lo
         }
     };
 
+    /** Session start time for notification elapsed time (showTime). */
+    private volatile long mSessionStartTime = 0L;
+    /** Accumulated distance in meters for notification (showDistance). */
+    private volatile double mSessionDistanceMeters = 0.0;
+    private volatile double mLastLat = 0.0;
+    private volatile double mLastLon = 0.0;
+    private volatile boolean mHasLastLocation = false;
+    private static final long NOTIFICATION_UPDATE_INTERVAL_MS = 1000L;
+    private final Runnable mNotificationUpdateRunnable = new Runnable() {
+        @Override
+        public void run() {
+            if (!sIsRunning || !mIsInForeground || mConfig == null) {
+                return;
+            }
+            boolean showTime = Boolean.TRUE.equals(mConfig.getShowTime());
+            boolean showDistance = Boolean.TRUE.equals(mConfig.getShowDistance());
+            if (!showTime && !showDistance) {
+                return;
+            }
+            updateForegroundNotification();
+            mMainHandler.postDelayed(this, NOTIFICATION_UPDATE_INTERVAL_MS);
+        }
+    };
+
     private static LocationTransform sLocationTransform;
     private static LocationProviderFactory sLocationProviderFactory;
 
@@ -418,6 +445,12 @@ public class LocationServiceImpl extends Service implements ProviderDelegate, Lo
             mMainHandler.postDelayed(mWatchdogRunnable, WATCHDOG_INTERVAL_MS);
         }
 
+        mSessionStartTime = System.currentTimeMillis();
+        mSessionDistanceMeters = 0.0;
+        mLastLat = 0.0;
+        mLastLon = 0.0;
+        mHasLastLocation = false;
+
         ThreadUtils.runOnUiThreadBlocking(new Runnable() {
             @Override
             public void run() {
@@ -447,6 +480,7 @@ public class LocationServiceImpl extends Service implements ProviderDelegate, Lo
         }
 
         mMainHandler.removeCallbacks(mWatchdogRunnable);
+        mMainHandler.removeCallbacks(mNotificationUpdateRunnable);
 
         if (mWakeLock != null && mWakeLock.isHeld()) {
             try {
@@ -461,6 +495,7 @@ public class LocationServiceImpl extends Service implements ProviderDelegate, Lo
             mProvider.onStop();
         }
 
+        mIsInForeground = false;
         stopForeground(true);
         stopSelf();
 
@@ -530,9 +565,10 @@ public class LocationServiceImpl extends Service implements ProviderDelegate, Lo
                 return;
             }
             Config config = getConfig();
+            String contentText = buildNotificationContentText(config);
             Notification notification = new NotificationHelper.NotificationFactory(this).getNotification(
                     config.getNotificationTitle(),
-                    config.getNotificationText(),
+                    contentText,
                     config.getLargeNotificationIcon(),
                     config.getSmallNotificationIcon(),
                     config.getNotificationIconColor());
@@ -548,12 +584,14 @@ public class LocationServiceImpl extends Service implements ProviderDelegate, Lo
                 super.startForeground(NOTIFICATION_ID, notification);
             }
             mIsInForeground = true;
+            scheduleNotificationUpdater();
         }
     }
 
     @Override
     public synchronized void stopForeground() {
         if (sIsRunning && mIsInForeground) {
+            mMainHandler.removeCallbacks(mNotificationUpdateRunnable);
             stopForeground(true);
             if (mProvider != null) {
                 mProvider.onCommand(LocationProvider.CMD_SWITCH_MODE,
@@ -563,6 +601,70 @@ public class LocationServiceImpl extends Service implements ProviderDelegate, Lo
         }
     }
 
+    /** Resource names for optional app-localized notification labels (showTime / showDistance). */
+    private static final String RES_NOTIFICATION_TIME_LABEL = "plugin_bgloc_notification_time_label";
+    private static final String RES_NOTIFICATION_DISTANCE_LABEL = "plugin_bgloc_notification_distance_label";
+
+    private String getNotificationLabel(String resourceName, String defaultValue) {
+        Context app = getApplicationContext();
+        int id = app.getResources().getIdentifier(resourceName, "string", app.getPackageName());
+        return (id != 0) ? app.getString(id) : defaultValue;
+    }
+
+    private String buildNotificationContentText(Config config) {
+        String base = config.getNotificationText() != null ? config.getNotificationText() : "ENABLED";
+        if (Boolean.TRUE.equals(config.getShowTime())) {
+            String timeLabel = getNotificationLabel(RES_NOTIFICATION_TIME_LABEL, "Time");
+            base += "\n" + timeLabel + ": " + formatElapsed(mSessionStartTime);
+        }
+        if (Boolean.TRUE.equals(config.getShowDistance())) {
+            String distanceLabel = getNotificationLabel(RES_NOTIFICATION_DISTANCE_LABEL, "Distance");
+            base += "\n" + distanceLabel + ": " + formatDistance(mSessionDistanceMeters);
+        }
+        return base;
+    }
+
+    private static String formatElapsed(long startTimeMs) {
+        long elapsed = Math.max(0L, System.currentTimeMillis() - startTimeMs);
+        long s = (elapsed / 1000L) % 60L;
+        long m = (elapsed / 60000L) % 60L;
+        long h = elapsed / 3600000L;
+        return String.format(Locale.US, "%02d:%02d:%02d", h, m, s);
+    }
+
+    private static String formatDistance(double meters) {
+        return String.format(Locale.US, "%.2f km", meters / 1000.0);
+    }
+
+    private void updateForegroundNotification() {
+        if (!sIsRunning || !mIsInForeground || mConfig == null) {
+            return;
+        }
+        String contentText = buildNotificationContentText(mConfig);
+        Notification notification = new NotificationHelper.NotificationFactory(this).getNotification(
+                mConfig.getNotificationTitle(),
+                contentText,
+                mConfig.getLargeNotificationIcon(),
+                mConfig.getSmallNotificationIcon(),
+                mConfig.getNotificationIconColor());
+        NotificationManager nm = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
+        if (nm != null) {
+            nm.notify(NOTIFICATION_ID, notification);
+        }
+    }
+
+    private void scheduleNotificationUpdater() {
+        mMainHandler.removeCallbacks(mNotificationUpdateRunnable);
+        if (mConfig == null) {
+            return;
+        }
+        boolean showTime = Boolean.TRUE.equals(mConfig.getShowTime());
+        boolean showDistance = Boolean.TRUE.equals(mConfig.getShowDistance());
+        if ((showTime || showDistance) && sIsRunning && mIsInForeground) {
+            mMainHandler.postDelayed(mNotificationUpdateRunnable, NOTIFICATION_UPDATE_INTERVAL_MS);
+        }
+    }
+
     @Override
     public synchronized void configure(Config config) {
         if (mConfig == null) {
@@ -580,7 +682,7 @@ public class LocationServiceImpl extends Service implements ProviderDelegate, Lo
             public void run() {
                 if (sIsRunning) {
                     if (currentConfig.getStartForeground() == true && mConfig.getStartForeground() == false) {
-                        stopForeground(true);
+                        stopForeground();
                     }
 
                     if (mConfig.getStartForeground() == true) {
@@ -589,15 +691,17 @@ public class LocationServiceImpl extends Service implements ProviderDelegate, Lo
                             startForeground();
                         } else {
                             // was running in foreground, so just update existing notification
+                            String contentText = buildNotificationContentText(mConfig);
                             Notification notification = new NotificationHelper.NotificationFactory(LocationServiceImpl.this).getNotification(
                                     mConfig.getNotificationTitle(),
-                                    mConfig.getNotificationText(),
+                                    contentText,
                                     mConfig.getLargeNotificationIcon(),
                                     mConfig.getSmallNotificationIcon(),
                                     mConfig.getNotificationIconColor());
 
                             NotificationManager notificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
                             notificationManager.notify(NOTIFICATION_ID, notification);
+                            scheduleNotificationUpdater();
                         }
                     }
                 }
@@ -661,6 +765,26 @@ public class LocationServiceImpl extends Service implements ProviderDelegate, Lo
     @Override
     public void onLocation(BackgroundLocation location) {
         mLastLocationTime = System.currentTimeMillis();
+        if (Boolean.TRUE.equals(mConfig != null ? mConfig.getShowDistance() : null)) {
+            double lat = location.getLatitude();
+            double lon = location.getLongitude();
+            if (mHasLastLocation) {
+                float[] dist = new float[1];
+                Location.distanceBetween(mLastLat, mLastLon, lat, lon, dist);
+                mSessionDistanceMeters += (double) dist[0];
+            }
+            mLastLat = lat;
+            mLastLon = lon;
+            mHasLastLocation = true;
+            if (mIsInForeground && mConfig != null && (Boolean.TRUE.equals(mConfig.getShowTime()) || Boolean.TRUE.equals(mConfig.getShowDistance()))) {
+                mMainHandler.post(new Runnable() {
+                    @Override
+                    public void run() {
+                        updateForegroundNotification();
+                    }
+                });
+            }
+        }
         logger.debug("New location {}", location.toString());
 
         location = transformLocation(location);

package/angular/dist/public-api.d.ts

@@ -6,4 +6,4 @@ export { BackgroundGeolocationService, BACKGROUND_GEOLOCATION_SERVICE, } from '.
 export { BackgroundGeolocationModule } from './background-geolocation.module';
 export { BackgroundGeolocationEvents } from './background-geolocation-events';
 export { BackgroundGeolocationLocationCode, BackgroundGeolocationNativeProvider, BackgroundGeolocationLocationProvider, BackgroundGeolocationAuthorizationStatus, BackgroundGeolocationLogLevel, BackgroundGeolocationProvider, BackgroundGeolocationAccuracy, BackgroundGeolocationMode, BackgroundGeolocationIOSActivity, } from './background-geolocation-enums';
-export type { BackgroundGeolocationConfig, BackgroundGeolocationResponse, ServiceStatus, BackgroundGeolocationLogEntry, } from '../www/BackgroundGeolocation';
+export type { BackgroundGeolocationConfig, BackgroundGeolocationResponse, ServiceStatus, BackgroundGeolocationLogEntry, } from '../../www/BackgroundGeolocation';

package/package.json

@@ -1,9 +1,13 @@
 {
   "name": "@josuelmm/cordova-background-geolocation",
-  "version": "3.1.0",
+  "version": "3.1.1",
   "description": "Cordova Background Geolocation (fork actualizado)",
   "main": "./www/BackgroundGeolocation.js",
   "types": "./www/BackgroundGeolocation.d.ts",
+  "browser": {
+    "cordova/exec": "./www/cordova-exec-stub.js",
+    "cordova/channel": "./www/cordova-channel-stub.js"
+  },
   "exports": {
     ".": {
       "types": "./www/BackgroundGeolocation.d.ts",
@@ -27,10 +31,10 @@
     "typescript": "~5.5.4"
   },
   "scripts": {
-    "build:angular": "npx ng-packagr -p angular/ng-package.json",
+    "build:angular": "npx ng-packagr -p angular/ng-package.json && node scripts/fix-angular-dts-paths.js",
     "prepack": "npm run build:angular",
     "pack": "npm pack",
-    "build-package": "npm run build:angular && npm pack"
+    "build": "npm run build:angular && npm pack"
   },
   "cordova": {
     "id": "cordova-background-geolocation",

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

package/www/BackgroundGeolocation.d.ts

@@ -214,6 +214,24 @@ export interface ConfigureOptions {
    */
   notificationText?: string;
 
+  /**
+   * When true, the foreground notification shows a live elapsed time (HH:mm:ss) since the session started.
+   * Requires startForeground. Updates every second.
+   *
+   * Platform: Android
+   * @default false
+   */
+  showTime?: boolean;
+
+  /**
+   * When true, the foreground notification shows accumulated distance (km) since the session started.
+   * Requires startForeground. Updates when each new location is received.
+   *
+   * Platform: Android
+   * @default false
+   */
+  showDistance?: boolean;
+
   /**
    * Title shown in the notification while locations are syncing to the server.
    * Use this (and notificationSyncText, etc.) to localize sync notifications.

package/www/cordova-channel-stub.js

@@ -0,0 +1,27 @@
+/**
+ * Stub for cordova/channel so the plugin can be bundled by webpack (ng serve / browser).
+ * When running inside Cordova (native), uses the real cordova channel.
+ * When running in browser, provides deviceready.subscribe() that runs the callback on load.
+ */
+function getChannel() {
+  if (typeof window !== 'undefined' && window.cordova && typeof window.cordova.require === 'function') {
+    try {
+      return window.cordova.require('cordova/channel');
+    } catch (e) {}
+  }
+  return {
+    deviceready: {
+      subscribe: function (cb) {
+        if (typeof window !== 'undefined') {
+          if (document.readyState === 'complete') {
+            setTimeout(cb, 0);
+          } else {
+            window.addEventListener('load', cb);
+          }
+        }
+      }
+    }
+  };
+}
+
+module.exports = getChannel();

package/www/cordova-exec-stub.js

@@ -0,0 +1,15 @@
+/**
+ * Stub for cordova/exec so the plugin can be bundled by webpack (ng serve / browser).
+ * When running inside Cordova (native), delegates to the real cordova.exec.
+ * When running in browser, calls the failure callback so the app does not break.
+ */
+function exec(success, fail, service, method, args) {
+  if (typeof window !== 'undefined' && window.cordova && typeof window.cordova.exec === 'function') {
+    return window.cordova.exec(success, fail, service, method, args || []);
+  }
+  if (typeof fail === 'function') {
+    fail({ message: 'Cordova is not available. Run on a device or emulator.' });
+  }
+}
+
+module.exports = exec;