@capgo/background-geolocation 7.0.8 → 7.0.9

package/README.md

@@ -208,8 +208,8 @@ Configration specific to Android can be made in `strings.xml`:
 
 <docgen-index>
 
-* [`addWatcher(...)`](#addwatcher)
-* [`removeWatcher(...)`](#removewatcher)
+* [`start(...)`](#start)
+* [`stop()`](#stop)
 * [`openSettings()`](#opensettings)
 * [Interfaces](#interfaces)
 

package/android/src/main/java/com/capgo/capacitor_background_geolocation/BackgroundGeolocation.java

@@ -1,17 +1,14 @@
 package com.capgo.capacitor_background_geolocation;
 
 import android.Manifest;
-import android.app.Notification;
 import android.app.NotificationChannel;
 import android.app.NotificationManager;
-import android.app.PendingIntent;
 import android.content.BroadcastReceiver;
 import android.content.ComponentName;
 import android.content.Context;
 import android.content.Intent;
 import android.content.IntentFilter;
 import android.content.ServiceConnection;
-import android.graphics.Color;
 import android.location.Location;
 import android.location.LocationManager;
 import android.net.Uri;
@@ -68,7 +65,7 @@ public class BackgroundGeolocation extends Plugin {
   }
 
   @PluginMethod(returnType = PluginMethod.RETURN_CALLBACK)
-  public void addWatcher(final PluginCall call) {
+  public void start(final PluginCall call) {
     if (
       getPermissionState("location") != PermissionState.GRANTED &&
       !call.getBoolean("requestPermissions", true)
@@ -77,6 +74,11 @@ public class BackgroundGeolocation extends Plugin {
       return;
     }
 
+    if (serviceConnectionFuture != null) {
+      call.reject("Service already started", "ALREADY_STARTED");
+      return;
+    }
+
     if (
       getPermissionState("location") != PermissionState.GRANTED &&
       call.getBoolean("requestPermissions", true)
@@ -84,7 +86,7 @@ public class BackgroundGeolocation extends Plugin {
       call.setKeepAlive(true);
       requestLocationPermissions(call)
         .thenRun(() -> {
-          proceedWithWatcher(call);
+          proceedWithStart(call);
         })
         .exceptionally(throwable -> {
           call.reject("User denied location permission", "NOT_AUTHORIZED");
@@ -101,17 +103,18 @@ public class BackgroundGeolocation extends Plugin {
 
     // Everything is OK, continuing to adding a watcher
     call.setKeepAlive(true);
-    proceedWithWatcher(call);
+    proceedWithStart(call);
   }
 
-  private void proceedWithWatcher(PluginCall call) {
+  private void proceedWithStart(PluginCall call) {
     if (call.getBoolean("stale", false)) {
       fetchLastLocation(call);
     }
     getServiceConnection().thenAccept(serviceBinder -> {
-        serviceBinder.addWatcher(
+        serviceBinder.start(
           call.getCallbackId(),
-          createBackgroundNotification(call),
+          call.getString("backgroundTitle", "Using your location"),
+          call.getString("backgroundMessage", ""),
           call.getFloat("distanceFilter", 0f)
         );
       });
@@ -126,67 +129,6 @@ public class BackgroundGeolocation extends Plugin {
     return locationPermissionFuture;
   }
 
-  private Notification createBackgroundNotification(PluginCall call) {
-    String backgroundMessage = call.getString("backgroundMessage", "");
-
-    Notification.Builder builder = new Notification.Builder(getContext())
-      .setContentTitle(call.getString("backgroundTitle", "Using your location"))
-      .setContentText(backgroundMessage)
-      .setOngoing(true)
-      .setPriority(Notification.PRIORITY_HIGH)
-      .setWhen(System.currentTimeMillis());
-
-    try {
-      String name = getAppString(
-        "capacitor_background_geolocation_notification_icon",
-        "mipmap/ic_launcher"
-      );
-      String[] parts = name.split("/");
-      // It is actually necessary to set a valid icon for the notification to behave
-      // correctly when tapped. If there is no icon specified, tapping it will open the
-      // app's settings, rather than bringing the application to the foreground.
-      builder.setSmallIcon(getAppResourceIdentifier(parts[1], parts[0]));
-    } catch (Exception e) {
-      Logger.error("Could not set notification icon", e);
-    }
-
-    try {
-      String color = getAppString(
-        "capacitor_background_geolocation_notification_color",
-        null
-      );
-      if (color != null) {
-        builder.setColor(Color.parseColor(color));
-      }
-    } catch (Exception e) {
-      Logger.error("Could not set notification color", e);
-    }
-
-    Intent launchIntent = getContext()
-      .getPackageManager()
-      .getLaunchIntentForPackage(getContext().getPackageName());
-    if (launchIntent != null) {
-      launchIntent.addFlags(Intent.FLAG_ACTIVITY_REORDER_TO_FRONT);
-      builder.setContentIntent(
-        PendingIntent.getActivity(
-          getContext(),
-          0,
-          launchIntent,
-          PendingIntent.FLAG_CANCEL_CURRENT | PendingIntent.FLAG_IMMUTABLE
-        )
-      );
-    }
-
-    // Set the Channel ID for Android O.
-    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
-      builder.setChannelId(
-        BackgroundGeolocationService.class.getPackage().getName()
-      );
-    }
-
-    return builder.build();
-  }
-
   @PermissionCallback
   private void locationPermissionsCallback(PluginCall call) {
     if (locationPermissionFuture == null) {
@@ -217,21 +159,19 @@ public class BackgroundGeolocation extends Plugin {
   }
 
   @PluginMethod
-  public void removeWatcher(PluginCall call) {
-    String callbackId = call.getString("id");
-    if (callbackId == null) {
-      call.reject("Missing id.");
-      return;
+  public void stop(PluginCall call) {
+    if (serviceConnectionFuture == null) {
+      call.resolve();
     }
-
     getServiceConnection()
       .thenAccept(service -> {
-        service.removeWatcher(callbackId);
+        var callbackId = service.stop();
         PluginCall savedCall = getBridge().getSavedCall(callbackId);
         if (savedCall != null) {
           savedCall.release(getBridge());
         }
         call.resolve();
+        serviceConnectionFuture = null;
       })
       .exceptionally(throwable -> {
         call.reject("Service connection failed: " + throwable.getMessage());
@@ -321,19 +261,6 @@ public class BackgroundGeolocation extends Plugin {
     }
   }
 
-  // Gets the identifier of the app's resource by name, returning 0 if not found.
-  private int getAppResourceIdentifier(String name, String defType) {
-    return getContext()
-      .getResources()
-      .getIdentifier(name, defType, getContext().getPackageName());
-  }
-
-  // Gets a string from the app's strings.xml file, resorting to a fallback if it is not defined.
-  private String getAppString(String name, String fallback) {
-    int id = getAppResourceIdentifier(name, "string");
-    return id == 0 ? fallback : getContext().getString(id);
-  }
-
   @Override
   public void load() {
     super.load();
@@ -346,9 +273,10 @@ public class BackgroundGeolocation extends Plugin {
         );
       NotificationChannel channel = new NotificationChannel(
         BackgroundGeolocationService.class.getPackage().getName(),
-        getAppString(
+        BackgroundGeolocationService.getAppString(
           "capacitor_background_geolocation_notification_channel_name",
-          "Background Tracking"
+          "Background Tracking",
+          getContext()
         ),
         NotificationManager.IMPORTANCE_DEFAULT
       );
@@ -407,21 +335,11 @@ public class BackgroundGeolocation extends Plugin {
     return serviceConnectionFuture;
   }
 
-  @Override
-  protected void handleOnResume() {
-    super.handleOnResume();
-  }
-
-  @Override
-  protected void handleOnPause() {
-    super.handleOnPause();
-  }
-
   @Override
   protected void handleOnDestroy() {
     if (serviceConnectionFuture != null) {
       serviceConnectionFuture.thenAccept(
-        BackgroundGeolocationService.LocalBinder::stopService
+        BackgroundGeolocationService.LocalBinder::stop
       );
     }
 

package/android/src/main/java/com/capgo/capacitor_background_geolocation/BackgroundGeolocationService.java

@@ -1,16 +1,18 @@
 package com.capgo.capacitor_background_geolocation;
 
 import android.app.Notification;
+import android.app.PendingIntent;
 import android.app.Service;
 import android.content.Context;
 import android.content.Intent;
+import android.graphics.Color;
 import android.location.LocationListener;
 import android.location.LocationManager;
 import android.os.Binder;
+import android.os.Build;
 import android.os.IBinder;
 import androidx.localbroadcastmanager.content.LocalBroadcastManager;
 import com.getcapacitor.Logger;
-import java.util.HashSet;
 
 // A bound and started service that is promoted to a foreground service
 // (showing a persistent notification) when the first background watcher is
@@ -24,16 +26,10 @@ public class BackgroundGeolocationService extends Service {
   // Must be unique for this application.
   private static final int NOTIFICATION_ID = 28351;
 
-  private static class Watcher {
+  private String callbackId;
 
-    public String id;
-    public LocationManager client;
-    public float distanceFilter;
-    public LocationListener locationCallback;
-    public Notification backgroundNotification;
-  }
-
-  private HashSet<Watcher> watchers = new HashSet<>();
+  private LocationManager client;
+  private LocationListener locationCallback;
 
   @Override
   public IBinder onBind(Intent intent) {
@@ -46,59 +42,44 @@ public class BackgroundGeolocationService extends Service {
   // service is terminated immediately.
   @Override
   public boolean onUnbind(Intent intent) {
-    for (Watcher watcher : watchers) {
-      watcher.client.removeUpdates(watcher.locationCallback);
-    }
-    watchers = new HashSet<>();
+    client.removeUpdates(locationCallback);
     stopSelf();
     return false;
   }
 
-  private void requestLocationUpdates(Watcher watcher) {
-    try {
-      watcher.client.requestLocationUpdates(
-        LocationManager.GPS_PROVIDER,
-        1000,
-        watcher.distanceFilter,
-        watcher.locationCallback
-      );
-    } catch (SecurityException ignore) {
-      // According to Android Studio, this method can throw a Security Exception if
-      // permissions are not yet granted. Rather than check the permissions, which is fiddly,
-      // we simply ignore the exception.
-    }
-  }
-
   // Handles requests from the activity.
   public class LocalBinder extends Binder {
 
-    void addWatcher(
+    void start(
       final String id,
-      Notification backgroundNotification,
+      final String notificationTitle,
+      final String notificationMessage,
       float distanceFilter
     ) {
-      LocationManager locationManager = (LocationManager) getSystemService(
-        Context.LOCATION_SERVICE
-      );
+      client = (LocationManager) getSystemService(Context.LOCATION_SERVICE);
+      callbackId = id;
 
-      LocationListener listener = location -> {
+      locationCallback = location -> {
         Intent intent = new Intent(ACTION_BROADCAST);
         intent.putExtra("location", location);
-        intent.putExtra("id", id);
+        intent.putExtra("id", callbackId);
         LocalBroadcastManager.getInstance(
           getApplicationContext()
         ).sendBroadcast(intent);
       };
 
-      Watcher watcher = new Watcher();
-      watcher.id = id;
-      watcher.client = locationManager;
-      watcher.distanceFilter = distanceFilter;
-      watcher.locationCallback = listener;
-      watcher.backgroundNotification = backgroundNotification;
-      watchers.add(watcher);
-
-      requestLocationUpdates(watcher);
+      try {
+        client.requestLocationUpdates(
+          LocationManager.GPS_PROVIDER,
+          1000,
+          distanceFilter,
+          locationCallback
+        );
+      } catch (SecurityException ignore) {
+        // According to Android Studio, this method can throw a Security Exception if
+        // permissions are not yet granted. Rather than check the permissions, which is fiddly,
+        // we simply ignore the exception.
+      }
 
       // Promote the service to the foreground if necessary.
       // Ideally we would only call 'startForeground' if the service is not already
@@ -110,28 +91,109 @@ public class BackgroundGeolocationService extends Service {
         // This method has been known to fail due to weird
         // permission bugs, so we prevent any exceptions from
         // crashing the app. See issue #86.
-        startForeground(NOTIFICATION_ID, backgroundNotification);
+        startForeground(
+          NOTIFICATION_ID,
+          createBackgroundNotification(notificationTitle, notificationMessage)
+        );
       } catch (Exception exception) {
         Logger.error("Failed to foreground service", exception);
       }
     }
 
-    void removeWatcher(String id) {
-      for (Watcher watcher : watchers) {
-        if (watcher.id.equals(id)) {
-          watcher.client.removeUpdates(watcher.locationCallback);
-          watchers.remove(watcher);
-          break;
-        }
-      }
-      if (watchers.isEmpty()) {
-        stopService();
+    String stop() {
+      client.removeUpdates(locationCallback);
+      stopForeground(true);
+      stopSelf();
+      return callbackId;
+    }
+  }
+
+  private Notification createBackgroundNotification(
+    String backgroundTitle,
+    String backgroundMessage
+  ) {
+    Notification.Builder builder = new Notification.Builder(
+      getApplicationContext()
+    )
+      .setContentTitle(backgroundTitle)
+      .setContentText(backgroundMessage)
+      .setOngoing(true)
+      .setPriority(Notification.PRIORITY_HIGH)
+      .setWhen(System.currentTimeMillis());
+
+    try {
+      String name = getAppString(
+        "capacitor_background_geolocation_notification_icon",
+        "mipmap/ic_launcher",
+        getApplicationContext()
+      );
+      String[] parts = name.split("/");
+      // It is actually necessary to set a valid icon for the notification to behave
+      // correctly when tapped. If there is no icon specified, tapping it will open the
+      // app's settings, rather than bringing the application to the foreground.
+      builder.setSmallIcon(
+        getAppResourceIdentifier(parts[1], parts[0], getApplicationContext())
+      );
+    } catch (Exception e) {
+      Logger.error("Could not set notification icon", e);
+    }
+
+    try {
+      String color = getAppString(
+        "capacitor_background_geolocation_notification_color",
+        null,
+        getApplicationContext()
+      );
+      if (color != null) {
+        builder.setColor(Color.parseColor(color));
       }
+    } catch (Exception e) {
+      Logger.error("Could not set notification color", e);
     }
 
-    void stopService() {
-      stopForeground(true);
-      stopSelf();
+    Intent launchIntent = getApplicationContext()
+      .getPackageManager()
+      .getLaunchIntentForPackage(getApplicationContext().getPackageName());
+    if (launchIntent != null) {
+      launchIntent.addFlags(Intent.FLAG_ACTIVITY_REORDER_TO_FRONT);
+      builder.setContentIntent(
+        PendingIntent.getActivity(
+          getApplicationContext(),
+          0,
+          launchIntent,
+          PendingIntent.FLAG_CANCEL_CURRENT | PendingIntent.FLAG_IMMUTABLE
+        )
+      );
     }
+
+    // Set the Channel ID for Android O.
+    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+      builder.setChannelId(
+        BackgroundGeolocationService.class.getPackage().getName()
+      );
+    }
+
+    return builder.build();
+  }
+
+  // Gets the identifier of the app's resource by name, returning 0 if not found.
+  private static int getAppResourceIdentifier(
+    String name,
+    String defType,
+    Context context
+  ) {
+    return context
+      .getResources()
+      .getIdentifier(name, defType, context.getPackageName());
+  }
+
+  // Gets a string from the app's strings.xml file, resorting to a fallback if it is not defined.
+  public static String getAppString(
+    String name,
+    String fallback,
+    Context context
+  ) {
+    int id = getAppResourceIdentifier(name, "string", context);
+    return id == 0 ? fallback : context.getString(id);
   }
 }

package/dist/docs.json

@@ -11,13 +11,13 @@
     ],
     "methods": [
       {
-        "name": "addWatcher",
-        "signature": "(options: WatcherOptions, callback: (position?: Location | undefined, error?: CallbackError | undefined) => void) => Promise<string>",
+        "name": "start",
+        "signature": "(options: StartOptions, callback: (position?: Location | undefined, error?: CallbackError | undefined) => void) => Promise<void>",
         "parameters": [
           {
             "name": "options",
             "docs": "The watcher configuration options",
-            "type": "WatcherOptions"
+            "type": "StartOptions"
           },
           {
             "name": "callback",
@@ -25,7 +25,7 @@
             "type": "(position?: Location | undefined, error?: CallbackError | undefined) => void"
           }
         ],
-        "returns": "Promise<string>",
+        "returns": "Promise<void>",
         "tags": [
           {
             "name": "param",
@@ -45,33 +45,23 @@
           },
           {
             "name": "example",
-            "text": "const watcherId = await BackgroundGeolocation.addWatcher(\n  {\n    backgroundMessage: \"App is using your location in the background\",\n    backgroundTitle: \"Location Service\",\n    requestPermissions: true,\n    stale: false,\n    distanceFilter: 10\n  },\n  (location, error) => {\n    if (error) {\n      console.error('Location error:', error);\n      return;\n    }\n    if (location) {\n      console.log('New location:', location.latitude, location.longitude);\n    }\n  }\n);"
+            "text": "await BackgroundGeolocation.start(\n  {\n    backgroundMessage: \"App is using your location in the background\",\n    backgroundTitle: \"Location Service\",\n    requestPermissions: true,\n    stale: false,\n    distanceFilter: 10\n  },\n  (location, error) => {\n    if (error) {\n      console.error('Location error:', error);\n      return;\n    }\n    if (location) {\n      console.log('New location:', location.latitude, location.longitude);\n    }\n  }\n);"
           }
         ],
         "docs": "Adds a watcher for location updates.\nThe watcher will be invoked with the latest location whenever it is available.\nIf an error occurs, the callback will be invoked with the error.",
         "complexTypes": [
-          "WatcherOptions",
+          "StartOptions",
           "Location",
           "CallbackError"
         ],
-        "slug": "addwatcher"
+        "slug": "start"
       },
       {
-        "name": "removeWatcher",
-        "signature": "(options: { id: string; }) => Promise<void>",
-        "parameters": [
-          {
-            "name": "options",
-            "docs": "Object containing the watcher ID to remove",
-            "type": "{ id: string; }"
-          }
-        ],
+        "name": "stop",
+        "signature": "() => Promise<void>",
+        "parameters": [],
         "returns": "Promise<void>",
         "tags": [
-          {
-            "name": "param",
-            "text": "options Object containing the watcher ID to remove"
-          },
           {
             "name": "returns",
             "text": "A promise that resolves when the watcher is successfully removed"
@@ -82,12 +72,12 @@
           },
           {
             "name": "example",
-            "text": "await BackgroundGeolocation.removeWatcher({ id: watcherId });"
+            "text": "await BackgroundGeolocation.stop();"
           }
         ],
-        "docs": "Removes a watcher by its unique identifier.\nStops location updates for the specified watcher.",
+        "docs": "Stops location updates.",
         "complexTypes": [],
-        "slug": "removewatcher"
+        "slug": "stop"
       },
       {
         "name": "openSettings",
@@ -117,9 +107,9 @@
   },
   "interfaces": [
     {
-      "name": "WatcherOptions",
-      "slug": "watcheroptions",
-      "docs": "The options for configuring a watcher that listens for location updates.",
+      "name": "StartOptions",
+      "slug": "startoptions",
+      "docs": "The options for configuring for location updates.",
       "tags": [
         {
           "text": "1.0.0",

package/dist/esm/definitions.d.ts

@@ -1,9 +1,9 @@
 /**
- * The options for configuring a watcher that listens for location updates.
+ * The options for configuring for location updates.
  *
  * @since 1.0.0
  */
-export interface WatcherOptions {
+export interface StartOptions {
     /**
      * If the "backgroundMessage" option is defined, the watcher will
      * provide location updates whether the app is in the background or the
@@ -180,7 +180,7 @@ export interface BackgroundGeolocationPlugin {
      *
      * @since 1.0.0
      * @example
-     * const watcherId = await BackgroundGeolocation.addWatcher(
+     * await BackgroundGeolocation.start(
      *   {
      *     backgroundMessage: "App is using your location in the background",
      *     backgroundTitle: "Location Service",
@@ -199,21 +199,17 @@ export interface BackgroundGeolocationPlugin {
      *   }
      * );
      */
-    addWatcher(options: WatcherOptions, callback: (position?: Location, error?: CallbackError) => void): Promise<string>;
+    start(options: StartOptions, callback: (position?: Location, error?: CallbackError) => void): Promise<void>;
     /**
-     * Removes a watcher by its unique identifier.
-     * Stops location updates for the specified watcher.
+     * Stops location updates.
      *
-     * @param options Object containing the watcher ID to remove
      * @returns A promise that resolves when the watcher is successfully removed
      *
      * @since 1.0.0
      * @example
-     * await BackgroundGeolocation.removeWatcher({ id: watcherId });
+     * await BackgroundGeolocation.stop();
      */
-    removeWatcher(options: {
-        id: string;
-    }): Promise<void>;
+    stop(): Promise<void>;
     /**
      * Opens the device's location settings page.
      * Useful for directing users to enable location services or adjust permissions.

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * The options for configuring a watcher that listens for location updates.\n *\n * @since 1.0.0\n */\nexport interface WatcherOptions {\n  /**\n   * If the \"backgroundMessage\" option is defined, the watcher will\n   * provide location updates whether the app is in the background or the\n   * foreground. If it is not defined, location updates are only\n   * guaranteed in the foreground. This is true on both platforms.\n   *\n   * On Android, a notification must be shown to continue receiving\n   * location updates in the background. This option specifies the text of\n   * that notification.\n   *\n   * @since 1.0.0\n   * @example \"Getting your location to provide better service\"\n   */\n  backgroundMessage?: string;\n  /**\n   * The title of the notification mentioned above.\n   *\n   * @since 1.0.0\n   * @default \"Using your location\"\n   * @example \"Location Service\"\n   */\n  backgroundTitle?: string;\n  /**\n   * Whether permissions should be requested from the user automatically,\n   * if they are not already granted.\n   *\n   * @since 1.0.0\n   * @default true\n   * @example\n   * // Auto-request permissions\n   * requestPermissions: true\n   *\n   * // Don't auto-request, handle manually\n   * requestPermissions: false\n   */\n  requestPermissions?: boolean;\n  /**\n   * If \"true\", stale locations may be delivered while the device\n   * obtains a GPS fix. You are responsible for checking the \"time\"\n   * property. If \"false\", locations are guaranteed to be up to date.\n   *\n   * @since 1.0.0\n   * @default false\n   * @example\n   * // Allow stale locations for faster initial response\n   * stale: true\n   *\n   * // Only fresh locations\n   * stale: false\n   */\n  stale?: boolean;\n  /**\n   * The distance in meters that the device must move before a new location update is triggered.\n   * This is used to filter out small movements and reduce the number of updates.\n   *\n   * @since 1.0.0\n   * @default 0\n   * @example\n   * // Update every 10 meters\n   * distanceFilter: 10\n   *\n   * // Update on any movement\n   * distanceFilter: 0\n   */\n  distanceFilter?: number;\n}\n\n/**\n * Represents a geographical location with various attributes.\n * Contains all the standard location properties returned by GPS/network providers.\n *\n * @since 1.0.0\n */\nexport interface Location {\n  /**\n   * Latitude in degrees.\n   * Range: -90.0 to +90.0\n   *\n   * @since 1.0.0\n   * @example 40.7128\n   */\n  latitude: number;\n  /**\n   * Longitude in degrees.\n   * Range: -180.0 to +180.0\n   *\n   * @since 1.0.0\n   * @example -74.0060\n   */\n  longitude: number;\n  /**\n   * Radius of horizontal uncertainty in metres, with 68% confidence.\n   * Lower values indicate more accurate location.\n   *\n   * @since 1.0.0\n   * @example 5.0\n   */\n  accuracy: number;\n  /**\n   * Metres above sea level (or null if not available).\n   *\n   * @since 1.0.0\n   * @example 10.5\n   */\n  altitude: number | null;\n  /**\n   * Vertical uncertainty in metres, with 68% confidence (or null if not available).\n   *\n   * @since 1.0.0\n   * @example 3.0\n   */\n  altitudeAccuracy: number | null;\n  /**\n   * `true` if the location was simulated by software, rather than GPS.\n   * Useful for detecting mock locations in development or testing.\n   *\n   * @since 1.0.0\n   * @example false\n   */\n  simulated: boolean;\n  /**\n   * Deviation from true north in degrees (or null if not available).\n   * Range: 0.0 to 360.0\n   *\n   * @since 1.0.0\n   * @example 45.5\n   */\n  bearing: number | null;\n  /**\n   * Speed in metres per second (or null if not available).\n   *\n   * @since 1.0.0\n   * @example 2.5\n   */\n  speed: number | null;\n  /**\n   * Time the location was produced, in milliseconds since the unix epoch.\n   * Use this to check if a location is stale when using stale: true.\n   *\n   * @since 1.0.0\n   * @example 1640995200000\n   */\n  time: number | null;\n}\n\n/**\n * Error object that may be passed to the location watcher callback.\n * Extends the standard Error with optional error codes.\n *\n * @since 1.0.0\n */\nexport interface CallbackError extends Error {\n  /**\n   * Optional error code for more specific error handling.\n   *\n   * @since 1.0.0\n   * @example \"PERMISSION_DENIED\"\n   */\n  code?: string;\n}\n\n/**\n * Main plugin interface for background geolocation functionality.\n * Provides methods to manage location watchers and access device settings.\n *\n * @since 1.0.0\n */\nexport interface BackgroundGeolocationPlugin {\n  /**\n   * Adds a watcher for location updates.\n   * The watcher will be invoked with the latest location whenever it is available.\n   * If an error occurs, the callback will be invoked with the error.\n   *\n   * @param options The watcher configuration options\n   * @param callback The callback function invoked when a new location is available or an error occurs\n   * @returns A promise that resolves to a unique identifier for the watcher ID\n   *\n   * @since 1.0.0\n   * @example\n   * const watcherId = await BackgroundGeolocation.addWatcher(\n   *   {\n   *     backgroundMessage: \"App is using your location in the background\",\n   *     backgroundTitle: \"Location Service\",\n   *     requestPermissions: true,\n   *     stale: false,\n   *     distanceFilter: 10\n   *   },\n   *   (location, error) => {\n   *     if (error) {\n   *       console.error('Location error:', error);\n   *       return;\n   *     }\n   *     if (location) {\n   *       console.log('New location:', location.latitude, location.longitude);\n   *     }\n   *   }\n   * );\n   */\n  addWatcher(\n    options: WatcherOptions,\n    callback: (position?: Location, error?: CallbackError) => void,\n  ): Promise<string>;\n\n  /**\n   * Removes a watcher by its unique identifier.\n   * Stops location updates for the specified watcher.\n   *\n   * @param options Object containing the watcher ID to remove\n   * @returns A promise that resolves when the watcher is successfully removed\n   *\n   * @since 1.0.0\n   * @example\n   * await BackgroundGeolocation.removeWatcher({ id: watcherId });\n   */\n  removeWatcher(options: { id: string }): Promise<void>;\n\n  /**\n   * Opens the device's location settings page.\n   * Useful for directing users to enable location services or adjust permissions.\n   *\n   * @returns A promise that resolves when the settings page is opened\n   *\n   * @since 1.0.0\n   * @example\n   * // Direct user to location settings\n   * await BackgroundGeolocation.openSettings();\n   */\n  openSettings(): Promise<void>;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * The options for configuring for location updates.\n *\n * @since 1.0.0\n */\nexport interface StartOptions {\n  /**\n   * If the \"backgroundMessage\" option is defined, the watcher will\n   * provide location updates whether the app is in the background or the\n   * foreground. If it is not defined, location updates are only\n   * guaranteed in the foreground. This is true on both platforms.\n   *\n   * On Android, a notification must be shown to continue receiving\n   * location updates in the background. This option specifies the text of\n   * that notification.\n   *\n   * @since 1.0.0\n   * @example \"Getting your location to provide better service\"\n   */\n  backgroundMessage?: string;\n  /**\n   * The title of the notification mentioned above.\n   *\n   * @since 1.0.0\n   * @default \"Using your location\"\n   * @example \"Location Service\"\n   */\n  backgroundTitle?: string;\n  /**\n   * Whether permissions should be requested from the user automatically,\n   * if they are not already granted.\n   *\n   * @since 1.0.0\n   * @default true\n   * @example\n   * // Auto-request permissions\n   * requestPermissions: true\n   *\n   * // Don't auto-request, handle manually\n   * requestPermissions: false\n   */\n  requestPermissions?: boolean;\n  /**\n   * If \"true\", stale locations may be delivered while the device\n   * obtains a GPS fix. You are responsible for checking the \"time\"\n   * property. If \"false\", locations are guaranteed to be up to date.\n   *\n   * @since 1.0.0\n   * @default false\n   * @example\n   * // Allow stale locations for faster initial response\n   * stale: true\n   *\n   * // Only fresh locations\n   * stale: false\n   */\n  stale?: boolean;\n  /**\n   * The distance in meters that the device must move before a new location update is triggered.\n   * This is used to filter out small movements and reduce the number of updates.\n   *\n   * @since 1.0.0\n   * @default 0\n   * @example\n   * // Update every 10 meters\n   * distanceFilter: 10\n   *\n   * // Update on any movement\n   * distanceFilter: 0\n   */\n  distanceFilter?: number;\n}\n\n/**\n * Represents a geographical location with various attributes.\n * Contains all the standard location properties returned by GPS/network providers.\n *\n * @since 1.0.0\n */\nexport interface Location {\n  /**\n   * Latitude in degrees.\n   * Range: -90.0 to +90.0\n   *\n   * @since 1.0.0\n   * @example 40.7128\n   */\n  latitude: number;\n  /**\n   * Longitude in degrees.\n   * Range: -180.0 to +180.0\n   *\n   * @since 1.0.0\n   * @example -74.0060\n   */\n  longitude: number;\n  /**\n   * Radius of horizontal uncertainty in metres, with 68% confidence.\n   * Lower values indicate more accurate location.\n   *\n   * @since 1.0.0\n   * @example 5.0\n   */\n  accuracy: number;\n  /**\n   * Metres above sea level (or null if not available).\n   *\n   * @since 1.0.0\n   * @example 10.5\n   */\n  altitude: number | null;\n  /**\n   * Vertical uncertainty in metres, with 68% confidence (or null if not available).\n   *\n   * @since 1.0.0\n   * @example 3.0\n   */\n  altitudeAccuracy: number | null;\n  /**\n   * `true` if the location was simulated by software, rather than GPS.\n   * Useful for detecting mock locations in development or testing.\n   *\n   * @since 1.0.0\n   * @example false\n   */\n  simulated: boolean;\n  /**\n   * Deviation from true north in degrees (or null if not available).\n   * Range: 0.0 to 360.0\n   *\n   * @since 1.0.0\n   * @example 45.5\n   */\n  bearing: number | null;\n  /**\n   * Speed in metres per second (or null if not available).\n   *\n   * @since 1.0.0\n   * @example 2.5\n   */\n  speed: number | null;\n  /**\n   * Time the location was produced, in milliseconds since the unix epoch.\n   * Use this to check if a location is stale when using stale: true.\n   *\n   * @since 1.0.0\n   * @example 1640995200000\n   */\n  time: number | null;\n}\n\n/**\n * Error object that may be passed to the location watcher callback.\n * Extends the standard Error with optional error codes.\n *\n * @since 1.0.0\n */\nexport interface CallbackError extends Error {\n  /**\n   * Optional error code for more specific error handling.\n   *\n   * @since 1.0.0\n   * @example \"PERMISSION_DENIED\"\n   */\n  code?: string;\n}\n\n/**\n * Main plugin interface for background geolocation functionality.\n * Provides methods to manage location watchers and access device settings.\n *\n * @since 1.0.0\n */\nexport interface BackgroundGeolocationPlugin {\n  /**\n   * Adds a watcher for location updates.\n   * The watcher will be invoked with the latest location whenever it is available.\n   * If an error occurs, the callback will be invoked with the error.\n   *\n   * @param options The watcher configuration options\n   * @param callback The callback function invoked when a new location is available or an error occurs\n   * @returns A promise that resolves to a unique identifier for the watcher ID\n   *\n   * @since 1.0.0\n   * @example\n   * await BackgroundGeolocation.start(\n   *   {\n   *     backgroundMessage: \"App is using your location in the background\",\n   *     backgroundTitle: \"Location Service\",\n   *     requestPermissions: true,\n   *     stale: false,\n   *     distanceFilter: 10\n   *   },\n   *   (location, error) => {\n   *     if (error) {\n   *       console.error('Location error:', error);\n   *       return;\n   *     }\n   *     if (location) {\n   *       console.log('New location:', location.latitude, location.longitude);\n   *     }\n   *   }\n   * );\n   */\n  start(\n    options: StartOptions,\n    callback: (position?: Location, error?: CallbackError) => void,\n  ): Promise<void>;\n\n  /**\n   * Stops location updates.\n   *\n   * @returns A promise that resolves when the watcher is successfully removed\n   *\n   * @since 1.0.0\n   * @example\n   * await BackgroundGeolocation.stop();\n   */\n  stop(): Promise<void>;\n\n  /**\n   * Opens the device's location settings page.\n   * Useful for directing users to enable location services or adjust permissions.\n   *\n   * @returns A promise that resolves when the settings page is opened\n   *\n   * @since 1.0.0\n   * @example\n   * // Direct user to location settings\n   * await BackgroundGeolocation.openSettings();\n   */\n  openSettings(): Promise<void>;\n}\n"]}

package/dist/esm/web.d.ts

@@ -1,11 +1,8 @@
 import { WebPlugin } from "@capacitor/core";
-import type { BackgroundGeolocationPlugin, WatcherOptions, Location, CallbackError } from "./definitions";
+import type { BackgroundGeolocationPlugin, StartOptions, Location, CallbackError } from "./definitions";
 export declare class BackgroundGeolocationWeb extends WebPlugin implements BackgroundGeolocationPlugin {
-    private watchers;
-    private watcherCounter;
-    addWatcher(options: WatcherOptions, callback: (position?: Location, error?: CallbackError) => void): Promise<string>;
-    removeWatcher(options: {
-        id: string;
-    }): Promise<void>;
+    private watchId;
+    start(options: StartOptions, callback: (position?: Location, error?: CallbackError) => void): Promise<void>;
+    stop(): Promise<void>;
     openSettings(): Promise<void>;
 }

package/dist/esm/web.js

@@ -1,21 +1,23 @@
 import { WebPlugin } from "@capacitor/core";
 export class BackgroundGeolocationWeb extends WebPlugin {
-    constructor() {
-        super(...arguments);
-        this.watchers = new Map();
-        this.watcherCounter = 0;
-    }
-    async addWatcher(options, callback) {
-        const watcherId = `watcher_${++this.watcherCounter}`;
+    async start(options, callback) {
         if (!navigator.geolocation) {
             callback(undefined, {
                 name: "GeolocationError",
                 message: "Geolocation is not supported by this browser",
                 code: "NOT_SUPPORTED",
             });
-            return watcherId;
+            return;
+        }
+        if (this.watchId) {
+            callback(undefined, {
+                name: "GeolocationError",
+                message: "Geolocation already started",
+                code: "ALREADY_STARTED",
+            });
+            return;
         }
-        const watchId = navigator.geolocation.watchPosition((position) => {
+        this.watchId = navigator.geolocation.watchPosition((position) => {
             const location = {
                 latitude: position.coords.latitude,
                 longitude: position.coords.longitude,
@@ -40,14 +42,11 @@ export class BackgroundGeolocationWeb extends WebPlugin {
             timeout: 10000,
             maximumAge: options.stale ? 300000 : 0,
         });
-        this.watchers.set(watcherId, { watchId, callback });
-        return watcherId;
     }
-    async removeWatcher(options) {
-        const watcher = this.watchers.get(options.id);
-        if (watcher) {
-            navigator.geolocation.clearWatch(watcher.watchId);
-            this.watchers.delete(options.id);
+    async stop() {
+        if (this.watchId) {
+            navigator.geolocation.clearWatch(this.watchId);
+            delete this.watchId;
         }
     }
     async openSettings() {

package/dist/esm/web.js.map

@@ -1 +1 @@
-{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAS5C,MAAM,OAAO,wBACX,SAAQ,SAAS;IADnB;;QAIU,aAAQ,GAAG,IAAI,GAAG,EAMvB,CAAC;QACI,mBAAc,GAAG,CAAC,CAAC;IA+D7B,CAAC;IA7DC,KAAK,CAAC,UAAU,CACd,OAAuB,EACvB,QAA8D;QAE9D,MAAM,SAAS,GAAG,WAAW,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC;QAErD,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;YAC3B,QAAQ,CAAC,SAAS,EAAE;gBAClB,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,8CAA8C;gBACvD,IAAI,EAAE,eAAe;aACtB,CAAC,CAAC;YACH,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,OAAO,GAAG,SAAS,CAAC,WAAW,CAAC,aAAa,CACjD,CAAC,QAAQ,EAAE,EAAE;YACX,MAAM,QAAQ,GAAa;gBACzB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ;gBAClC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS;gBACpC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ;gBAClC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ;gBAClC,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,gBAAgB;gBAClD,SAAS,EAAE,KAAK;gBAChB,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO;gBAChC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK;gBAC5B,IAAI,EAAE,QAAQ,CAAC,SAAS;aACzB,CAAC;YACF,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACrB,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;YACR,MAAM,aAAa,GAAkB;gBACnC,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE;aAC5B,CAAC;YACF,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QACrC,CAAC,EACD;YACE,kBAAkB,EAAE,IAAI;YACxB,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;SACvC,CACF,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QACpD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAuB;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC9C,IAAI,OAAO,EAAE,CAAC;YACZ,SAAS,CAAC,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAClD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;QAC5E,MAAM,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC;IAC9E,CAAC;CACF","sourcesContent":["import { WebPlugin } from \"@capacitor/core\";\n\nimport type {\n  BackgroundGeolocationPlugin,\n  WatcherOptions,\n  Location,\n  CallbackError,\n} from \"./definitions\";\n\nexport class BackgroundGeolocationWeb\n  extends WebPlugin\n  implements BackgroundGeolocationPlugin\n{\n  private watchers = new Map<\n    string,\n    {\n      watchId: number;\n      callback: (position?: Location, error?: CallbackError) => void;\n    }\n  >();\n  private watcherCounter = 0;\n\n  async addWatcher(\n    options: WatcherOptions,\n    callback: (position?: Location, error?: CallbackError) => void,\n  ): Promise<string> {\n    const watcherId = `watcher_${++this.watcherCounter}`;\n\n    if (!navigator.geolocation) {\n      callback(undefined, {\n        name: \"GeolocationError\",\n        message: \"Geolocation is not supported by this browser\",\n        code: \"NOT_SUPPORTED\",\n      });\n      return watcherId;\n    }\n\n    const watchId = navigator.geolocation.watchPosition(\n      (position) => {\n        const location: Location = {\n          latitude: position.coords.latitude,\n          longitude: position.coords.longitude,\n          accuracy: position.coords.accuracy,\n          altitude: position.coords.altitude,\n          altitudeAccuracy: position.coords.altitudeAccuracy,\n          simulated: false,\n          bearing: position.coords.heading,\n          speed: position.coords.speed,\n          time: position.timestamp,\n        };\n        callback(location);\n      },\n      (error) => {\n        const callbackError: CallbackError = {\n          name: \"GeolocationError\",\n          message: error.message,\n          code: error.code.toString(),\n        };\n        callback(undefined, callbackError);\n      },\n      {\n        enableHighAccuracy: true,\n        timeout: 10000,\n        maximumAge: options.stale ? 300000 : 0,\n      },\n    );\n\n    this.watchers.set(watcherId, { watchId, callback });\n    return watcherId;\n  }\n\n  async removeWatcher(options: { id: string }): Promise<void> {\n    const watcher = this.watchers.get(options.id);\n    if (watcher) {\n      navigator.geolocation.clearWatch(watcher.watchId);\n      this.watchers.delete(options.id);\n    }\n  }\n\n  async openSettings(): Promise<void> {\n    console.log(\"openSettings: Web implementation cannot open native settings\");\n    window.alert(\"Please enable location permissions in your browser settings\");\n  }\n}\n"]}
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAS5C,MAAM,OAAO,wBACX,SAAQ,SAAS;IAKjB,KAAK,CAAC,KAAK,CACT,OAAqB,EACrB,QAA8D;QAE9D,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;YAC3B,QAAQ,CAAC,SAAS,EAAE;gBAClB,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,8CAA8C;gBACvD,IAAI,EAAE,eAAe;aACtB,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,QAAQ,CAAC,SAAS,EAAE;gBAClB,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,6BAA6B;gBACtC,IAAI,EAAE,iBAAiB;aACxB,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC,WAAW,CAAC,aAAa,CAChD,CAAC,QAAQ,EAAE,EAAE;YACX,MAAM,QAAQ,GAAa;gBACzB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ;gBAClC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS;gBACpC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ;gBAClC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ;gBAClC,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,gBAAgB;gBAClD,SAAS,EAAE,KAAK;gBAChB,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO;gBAChC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK;gBAC5B,IAAI,EAAE,QAAQ,CAAC,SAAS;aACzB,CAAC;YACF,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACrB,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;YACR,MAAM,aAAa,GAAkB;gBACnC,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE;aAC5B,CAAC;YACF,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QACrC,CAAC,EACD;YACE,kBAAkB,EAAE,IAAI;YACxB,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;SACvC,CACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,SAAS,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC/C,OAAO,IAAI,CAAC,OAAO,CAAC;QACtB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;QAC5E,MAAM,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC;IAC9E,CAAC;CACF","sourcesContent":["import { WebPlugin } from \"@capacitor/core\";\n\nimport type {\n  BackgroundGeolocationPlugin,\n  StartOptions,\n  Location,\n  CallbackError,\n} from \"./definitions\";\n\nexport class BackgroundGeolocationWeb\n  extends WebPlugin\n  implements BackgroundGeolocationPlugin\n{\n  private watchId: number | undefined;\n\n  async start(\n    options: StartOptions,\n    callback: (position?: Location, error?: CallbackError) => void,\n  ): Promise<void> {\n    if (!navigator.geolocation) {\n      callback(undefined, {\n        name: \"GeolocationError\",\n        message: \"Geolocation is not supported by this browser\",\n        code: \"NOT_SUPPORTED\",\n      });\n      return;\n    }\n\n    if (this.watchId) {\n      callback(undefined, {\n        name: \"GeolocationError\",\n        message: \"Geolocation already started\",\n        code: \"ALREADY_STARTED\",\n      });\n      return;\n    }\n\n    this.watchId = navigator.geolocation.watchPosition(\n      (position) => {\n        const location: Location = {\n          latitude: position.coords.latitude,\n          longitude: position.coords.longitude,\n          accuracy: position.coords.accuracy,\n          altitude: position.coords.altitude,\n          altitudeAccuracy: position.coords.altitudeAccuracy,\n          simulated: false,\n          bearing: position.coords.heading,\n          speed: position.coords.speed,\n          time: position.timestamp,\n        };\n        callback(location);\n      },\n      (error) => {\n        const callbackError: CallbackError = {\n          name: \"GeolocationError\",\n          message: error.message,\n          code: error.code.toString(),\n        };\n        callback(undefined, callbackError);\n      },\n      {\n        enableHighAccuracy: true,\n        timeout: 10000,\n        maximumAge: options.stale ? 300000 : 0,\n      },\n    );\n  }\n\n  async stop(): Promise<void> {\n    if (this.watchId) {\n      navigator.geolocation.clearWatch(this.watchId);\n      delete this.watchId;\n    }\n  }\n\n  async openSettings(): Promise<void> {\n    console.log(\"openSettings: Web implementation cannot open native settings\");\n    window.alert(\"Please enable location permissions in your browser settings\");\n  }\n}\n"]}

package/dist/plugin.cjs.js

@@ -7,22 +7,24 @@ const BackgroundGeolocation = core.registerPlugin("BackgroundGeolocation", {
 });
 
 class BackgroundGeolocationWeb extends core.WebPlugin {
-    constructor() {
-        super(...arguments);
-        this.watchers = new Map();
-        this.watcherCounter = 0;
-    }
-    async addWatcher(options, callback) {
-        const watcherId = `watcher_${++this.watcherCounter}`;
+    async start(options, callback) {
         if (!navigator.geolocation) {
             callback(undefined, {
                 name: "GeolocationError",
                 message: "Geolocation is not supported by this browser",
                 code: "NOT_SUPPORTED",
             });
-            return watcherId;
+            return;
+        }
+        if (this.watchId) {
+            callback(undefined, {
+                name: "GeolocationError",
+                message: "Geolocation already started",
+                code: "ALREADY_STARTED",
+            });
+            return;
         }
-        const watchId = navigator.geolocation.watchPosition((position) => {
+        this.watchId = navigator.geolocation.watchPosition((position) => {
             const location = {
                 latitude: position.coords.latitude,
                 longitude: position.coords.longitude,
@@ -47,14 +49,11 @@ class BackgroundGeolocationWeb extends core.WebPlugin {
             timeout: 10000,
             maximumAge: options.stale ? 300000 : 0,
         });
-        this.watchers.set(watcherId, { watchId, callback });
-        return watcherId;
     }
-    async removeWatcher(options) {
-        const watcher = this.watchers.get(options.id);
-        if (watcher) {
-            navigator.geolocation.clearWatch(watcher.watchId);
-            this.watchers.delete(options.id);
+    async stop() {
+        if (this.watchId) {
+            navigator.geolocation.clearWatch(this.watchId);
+            delete this.watchId;
         }
     }
     async openSettings() {

package/dist/plugin.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from \"@capacitor/core\";\nconst BackgroundGeolocation = registerPlugin(\"BackgroundGeolocation\", {\n    web: () => import(\"./web\").then((m) => new m.BackgroundGeolocationWeb()),\n});\nexport * from \"./definitions\";\nexport { BackgroundGeolocation };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from \"@capacitor/core\";\nexport class BackgroundGeolocationWeb extends WebPlugin {\n    constructor() {\n        super(...arguments);\n        this.watchers = new Map();\n        this.watcherCounter = 0;\n    }\n    async addWatcher(options, callback) {\n        const watcherId = `watcher_${++this.watcherCounter}`;\n        if (!navigator.geolocation) {\n            callback(undefined, {\n                name: \"GeolocationError\",\n                message: \"Geolocation is not supported by this browser\",\n                code: \"NOT_SUPPORTED\",\n            });\n            return watcherId;\n        }\n        const watchId = navigator.geolocation.watchPosition((position) => {\n            const location = {\n                latitude: position.coords.latitude,\n                longitude: position.coords.longitude,\n                accuracy: position.coords.accuracy,\n                altitude: position.coords.altitude,\n                altitudeAccuracy: position.coords.altitudeAccuracy,\n                simulated: false,\n                bearing: position.coords.heading,\n                speed: position.coords.speed,\n                time: position.timestamp,\n            };\n            callback(location);\n        }, (error) => {\n            const callbackError = {\n                name: \"GeolocationError\",\n                message: error.message,\n                code: error.code.toString(),\n            };\n            callback(undefined, callbackError);\n        }, {\n            enableHighAccuracy: true,\n            timeout: 10000,\n            maximumAge: options.stale ? 300000 : 0,\n        });\n        this.watchers.set(watcherId, { watchId, callback });\n        return watcherId;\n    }\n    async removeWatcher(options) {\n        const watcher = this.watchers.get(options.id);\n        if (watcher) {\n            navigator.geolocation.clearWatch(watcher.watchId);\n            this.watchers.delete(options.id);\n        }\n    }\n    async openSettings() {\n        console.log(\"openSettings: Web implementation cannot open native settings\");\n        window.alert(\"Please enable location permissions in your browser settings\");\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":"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"}
+{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from \"@capacitor/core\";\nconst BackgroundGeolocation = registerPlugin(\"BackgroundGeolocation\", {\n    web: () => import(\"./web\").then((m) => new m.BackgroundGeolocationWeb()),\n});\nexport * from \"./definitions\";\nexport { BackgroundGeolocation };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from \"@capacitor/core\";\nexport class BackgroundGeolocationWeb extends WebPlugin {\n    async start(options, callback) {\n        if (!navigator.geolocation) {\n            callback(undefined, {\n                name: \"GeolocationError\",\n                message: \"Geolocation is not supported by this browser\",\n                code: \"NOT_SUPPORTED\",\n            });\n            return;\n        }\n        if (this.watchId) {\n            callback(undefined, {\n                name: \"GeolocationError\",\n                message: \"Geolocation already started\",\n                code: \"ALREADY_STARTED\",\n            });\n            return;\n        }\n        this.watchId = navigator.geolocation.watchPosition((position) => {\n            const location = {\n                latitude: position.coords.latitude,\n                longitude: position.coords.longitude,\n                accuracy: position.coords.accuracy,\n                altitude: position.coords.altitude,\n                altitudeAccuracy: position.coords.altitudeAccuracy,\n                simulated: false,\n                bearing: position.coords.heading,\n                speed: position.coords.speed,\n                time: position.timestamp,\n            };\n            callback(location);\n        }, (error) => {\n            const callbackError = {\n                name: \"GeolocationError\",\n                message: error.message,\n                code: error.code.toString(),\n            };\n            callback(undefined, callbackError);\n        }, {\n            enableHighAccuracy: true,\n            timeout: 10000,\n            maximumAge: options.stale ? 300000 : 0,\n        });\n    }\n    async stop() {\n        if (this.watchId) {\n            navigator.geolocation.clearWatch(this.watchId);\n            delete this.watchId;\n        }\n    }\n    async openSettings() {\n        console.log(\"openSettings: Web implementation cannot open native settings\");\n        window.alert(\"Please enable location permissions in your browser settings\");\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AACK,MAAC,qBAAqB,GAAGA,mBAAc,CAAC,uBAAuB,EAAE;AACtE,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,wBAAwB,EAAE,CAAC;AAC5E,CAAC;;ACFM,MAAM,wBAAwB,SAASC,cAAS,CAAC;AACxD,IAAI,MAAM,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE;AACnC,QAAQ,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;AACpC,YAAY,QAAQ,CAAC,SAAS,EAAE;AAChC,gBAAgB,IAAI,EAAE,kBAAkB;AACxC,gBAAgB,OAAO,EAAE,8CAA8C;AACvE,gBAAgB,IAAI,EAAE,eAAe;AACrC,aAAa,CAAC;AACd,YAAY;AACZ,QAAQ;AACR,QAAQ,IAAI,IAAI,CAAC,OAAO,EAAE;AAC1B,YAAY,QAAQ,CAAC,SAAS,EAAE;AAChC,gBAAgB,IAAI,EAAE,kBAAkB;AACxC,gBAAgB,OAAO,EAAE,6BAA6B;AACtD,gBAAgB,IAAI,EAAE,iBAAiB;AACvC,aAAa,CAAC;AACd,YAAY;AACZ,QAAQ;AACR,QAAQ,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,QAAQ,KAAK;AACzE,YAAY,MAAM,QAAQ,GAAG;AAC7B,gBAAgB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ;AAClD,gBAAgB,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS;AACpD,gBAAgB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ;AAClD,gBAAgB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ;AAClD,gBAAgB,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,gBAAgB;AAClE,gBAAgB,SAAS,EAAE,KAAK;AAChC,gBAAgB,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO;AAChD,gBAAgB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK;AAC5C,gBAAgB,IAAI,EAAE,QAAQ,CAAC,SAAS;AACxC,aAAa;AACb,YAAY,QAAQ,CAAC,QAAQ,CAAC;AAC9B,QAAQ,CAAC,EAAE,CAAC,KAAK,KAAK;AACtB,YAAY,MAAM,aAAa,GAAG;AAClC,gBAAgB,IAAI,EAAE,kBAAkB;AACxC,gBAAgB,OAAO,EAAE,KAAK,CAAC,OAAO;AACtC,gBAAgB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE;AAC3C,aAAa;AACb,YAAY,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;AAC9C,QAAQ,CAAC,EAAE;AACX,YAAY,kBAAkB,EAAE,IAAI;AACpC,YAAY,OAAO,EAAE,KAAK;AAC1B,YAAY,UAAU,EAAE,OAAO,CAAC,KAAK,GAAG,MAAM,GAAG,CAAC;AAClD,SAAS,CAAC;AACV,IAAI;AACJ,IAAI,MAAM,IAAI,GAAG;AACjB,QAAQ,IAAI,IAAI,CAAC,OAAO,EAAE;AAC1B,YAAY,SAAS,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC;AAC1D,YAAY,OAAO,IAAI,CAAC,OAAO;AAC/B,QAAQ;AACR,IAAI;AACJ,IAAI,MAAM,YAAY,GAAG;AACzB,QAAQ,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC;AACnF,QAAQ,MAAM,CAAC,KAAK,CAAC,6DAA6D,CAAC;AACnF,IAAI;AACJ;;;;;;;;;"}

package/dist/plugin.js

@@ -6,22 +6,24 @@ var capacitorBackgroundGeolocation = (function (exports, core) {
     });
 
     class BackgroundGeolocationWeb extends core.WebPlugin {
-        constructor() {
-            super(...arguments);
-            this.watchers = new Map();
-            this.watcherCounter = 0;
-        }
-        async addWatcher(options, callback) {
-            const watcherId = `watcher_${++this.watcherCounter}`;
+        async start(options, callback) {
             if (!navigator.geolocation) {
                 callback(undefined, {
                     name: "GeolocationError",
                     message: "Geolocation is not supported by this browser",
                     code: "NOT_SUPPORTED",
                 });
-                return watcherId;
+                return;
+            }
+            if (this.watchId) {
+                callback(undefined, {
+                    name: "GeolocationError",
+                    message: "Geolocation already started",
+                    code: "ALREADY_STARTED",
+                });
+                return;
             }
-            const watchId = navigator.geolocation.watchPosition((position) => {
+            this.watchId = navigator.geolocation.watchPosition((position) => {
                 const location = {
                     latitude: position.coords.latitude,
                     longitude: position.coords.longitude,
@@ -46,14 +48,11 @@ var capacitorBackgroundGeolocation = (function (exports, core) {
                 timeout: 10000,
                 maximumAge: options.stale ? 300000 : 0,
             });
-            this.watchers.set(watcherId, { watchId, callback });
-            return watcherId;
         }
-        async removeWatcher(options) {
-            const watcher = this.watchers.get(options.id);
-            if (watcher) {
-                navigator.geolocation.clearWatch(watcher.watchId);
-                this.watchers.delete(options.id);
+        async stop() {
+            if (this.watchId) {
+                navigator.geolocation.clearWatch(this.watchId);
+                delete this.watchId;
             }
         }
         async openSettings() {

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from \"@capacitor/core\";\nconst BackgroundGeolocation = registerPlugin(\"BackgroundGeolocation\", {\n    web: () => import(\"./web\").then((m) => new m.BackgroundGeolocationWeb()),\n});\nexport * from \"./definitions\";\nexport { BackgroundGeolocation };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from \"@capacitor/core\";\nexport class BackgroundGeolocationWeb extends WebPlugin {\n    constructor() {\n        super(...arguments);\n        this.watchers = new Map();\n        this.watcherCounter = 0;\n    }\n    async addWatcher(options, callback) {\n        const watcherId = `watcher_${++this.watcherCounter}`;\n        if (!navigator.geolocation) {\n            callback(undefined, {\n                name: \"GeolocationError\",\n                message: \"Geolocation is not supported by this browser\",\n                code: \"NOT_SUPPORTED\",\n            });\n            return watcherId;\n        }\n        const watchId = navigator.geolocation.watchPosition((position) => {\n            const location = {\n                latitude: position.coords.latitude,\n                longitude: position.coords.longitude,\n                accuracy: position.coords.accuracy,\n                altitude: position.coords.altitude,\n                altitudeAccuracy: position.coords.altitudeAccuracy,\n                simulated: false,\n                bearing: position.coords.heading,\n                speed: position.coords.speed,\n                time: position.timestamp,\n            };\n            callback(location);\n        }, (error) => {\n            const callbackError = {\n                name: \"GeolocationError\",\n                message: error.message,\n                code: error.code.toString(),\n            };\n            callback(undefined, callbackError);\n        }, {\n            enableHighAccuracy: true,\n            timeout: 10000,\n            maximumAge: options.stale ? 300000 : 0,\n        });\n        this.watchers.set(watcherId, { watchId, callback });\n        return watcherId;\n    }\n    async removeWatcher(options) {\n        const watcher = this.watchers.get(options.id);\n        if (watcher) {\n            navigator.geolocation.clearWatch(watcher.watchId);\n            this.watchers.delete(options.id);\n        }\n    }\n    async openSettings() {\n        console.log(\"openSettings: Web implementation cannot open native settings\");\n        window.alert(\"Please enable location permissions in your browser settings\");\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":"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"}
+{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from \"@capacitor/core\";\nconst BackgroundGeolocation = registerPlugin(\"BackgroundGeolocation\", {\n    web: () => import(\"./web\").then((m) => new m.BackgroundGeolocationWeb()),\n});\nexport * from \"./definitions\";\nexport { BackgroundGeolocation };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from \"@capacitor/core\";\nexport class BackgroundGeolocationWeb extends WebPlugin {\n    async start(options, callback) {\n        if (!navigator.geolocation) {\n            callback(undefined, {\n                name: \"GeolocationError\",\n                message: \"Geolocation is not supported by this browser\",\n                code: \"NOT_SUPPORTED\",\n            });\n            return;\n        }\n        if (this.watchId) {\n            callback(undefined, {\n                name: \"GeolocationError\",\n                message: \"Geolocation already started\",\n                code: \"ALREADY_STARTED\",\n            });\n            return;\n        }\n        this.watchId = navigator.geolocation.watchPosition((position) => {\n            const location = {\n                latitude: position.coords.latitude,\n                longitude: position.coords.longitude,\n                accuracy: position.coords.accuracy,\n                altitude: position.coords.altitude,\n                altitudeAccuracy: position.coords.altitudeAccuracy,\n                simulated: false,\n                bearing: position.coords.heading,\n                speed: position.coords.speed,\n                time: position.timestamp,\n            };\n            callback(location);\n        }, (error) => {\n            const callbackError = {\n                name: \"GeolocationError\",\n                message: error.message,\n                code: error.code.toString(),\n            };\n            callback(undefined, callbackError);\n        }, {\n            enableHighAccuracy: true,\n            timeout: 10000,\n            maximumAge: options.stale ? 300000 : 0,\n        });\n    }\n    async stop() {\n        if (this.watchId) {\n            navigator.geolocation.clearWatch(this.watchId);\n            delete this.watchId;\n        }\n    }\n    async openSettings() {\n        console.log(\"openSettings: Web implementation cannot open native settings\");\n        window.alert(\"Please enable location permissions in your browser settings\");\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;AACK,UAAC,qBAAqB,GAAGA,mBAAc,CAAC,uBAAuB,EAAE;IACtE,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,wBAAwB,EAAE,CAAC;IAC5E,CAAC;;ICFM,MAAM,wBAAwB,SAASC,cAAS,CAAC;IACxD,IAAI,MAAM,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE;IACnC,QAAQ,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;IACpC,YAAY,QAAQ,CAAC,SAAS,EAAE;IAChC,gBAAgB,IAAI,EAAE,kBAAkB;IACxC,gBAAgB,OAAO,EAAE,8CAA8C;IACvE,gBAAgB,IAAI,EAAE,eAAe;IACrC,aAAa,CAAC;IACd,YAAY;IACZ,QAAQ;IACR,QAAQ,IAAI,IAAI,CAAC,OAAO,EAAE;IAC1B,YAAY,QAAQ,CAAC,SAAS,EAAE;IAChC,gBAAgB,IAAI,EAAE,kBAAkB;IACxC,gBAAgB,OAAO,EAAE,6BAA6B;IACtD,gBAAgB,IAAI,EAAE,iBAAiB;IACvC,aAAa,CAAC;IACd,YAAY;IACZ,QAAQ;IACR,QAAQ,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,QAAQ,KAAK;IACzE,YAAY,MAAM,QAAQ,GAAG;IAC7B,gBAAgB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ;IAClD,gBAAgB,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS;IACpD,gBAAgB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ;IAClD,gBAAgB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ;IAClD,gBAAgB,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,gBAAgB;IAClE,gBAAgB,SAAS,EAAE,KAAK;IAChC,gBAAgB,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO;IAChD,gBAAgB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK;IAC5C,gBAAgB,IAAI,EAAE,QAAQ,CAAC,SAAS;IACxC,aAAa;IACb,YAAY,QAAQ,CAAC,QAAQ,CAAC;IAC9B,QAAQ,CAAC,EAAE,CAAC,KAAK,KAAK;IACtB,YAAY,MAAM,aAAa,GAAG;IAClC,gBAAgB,IAAI,EAAE,kBAAkB;IACxC,gBAAgB,OAAO,EAAE,KAAK,CAAC,OAAO;IACtC,gBAAgB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE;IAC3C,aAAa;IACb,YAAY,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAC9C,QAAQ,CAAC,EAAE;IACX,YAAY,kBAAkB,EAAE,IAAI;IACpC,YAAY,OAAO,EAAE,KAAK;IAC1B,YAAY,UAAU,EAAE,OAAO,CAAC,KAAK,GAAG,MAAM,GAAG,CAAC;IAClD,SAAS,CAAC;IACV,IAAI;IACJ,IAAI,MAAM,IAAI,GAAG;IACjB,QAAQ,IAAI,IAAI,CAAC,OAAO,EAAE;IAC1B,YAAY,SAAS,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC;IAC1D,YAAY,OAAO,IAAI,CAAC,OAAO;IAC/B,QAAQ;IACR,IAAI;IACJ,IAAI,MAAM,YAAY,GAAG;IACzB,QAAQ,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC;IACnF,QAAQ,MAAM,CAAC,KAAK,CAAC,6DAA6D,CAAC;IACnF,IAAI;IACJ;;;;;;;;;;;;;;;"}

package/ios/Plugin/Plugin.m

@@ -2,7 +2,7 @@
 #import <Capacitor/Capacitor.h>
 
 CAP_PLUGIN(BackgroundGeolocation, "BackgroundGeolocation",
-    CAP_PLUGIN_METHOD(addWatcher, CAPPluginReturnCallback);
-    CAP_PLUGIN_METHOD(removeWatcher, CAPPluginReturnPromise);
+    CAP_PLUGIN_METHOD(start, CAPPluginReturnCallback);
+    CAP_PLUGIN_METHOD(stop, CAPPluginReturnPromise);
     CAP_PLUGIN_METHOD(openSettings, CAPPluginReturnPromise);
 )

package/ios/Plugin/Plugin.swift

@@ -33,63 +33,41 @@ func formatLocation(_ location: CLLocation) -> PluginCallResultData {
     ]
 }
 
-class Watcher {
-    let callbackId: String
-    let locationManager: CLLocationManager = CLLocationManager()
-    private let created = Date()
-    private let allowStale: Bool
-    private var isUpdatingLocation: Bool = false
-    init(_ id: String, stale: Bool) {
-        callbackId = id
-        allowStale = stale
-    }
-    func start() {
-        // Avoid unnecessary calls to startUpdatingLocation, which can
-        // result in extraneous invocations of didFailWithError.
-        if !isUpdatingLocation {
-            locationManager.startUpdatingLocation()
-            isUpdatingLocation = true
-        }
-    }
-    func stop() {
-        if isUpdatingLocation {
-            locationManager.stopUpdatingLocation()
-            isUpdatingLocation = false
-        }
-    }
-    func isLocationValid(_ location: CLLocation) -> Bool {
-        return (
-            allowStale ||
-                location.timestamp >= created
-        )
-    }
-}
-
 @objc(BackgroundGeolocation)
 public class BackgroundGeolocation: CAPPlugin, CLLocationManagerDelegate {
-    private var watchers = [Watcher]()
+    private var locationManager: CLLocationManager?
+    private var created: Date?
+    private var allowStale: Bool = false
+    private var isUpdatingLocation: Bool = false
+    private var activeCallbackId: String?
 
     @objc override public func load() {
         UIDevice.current.isBatteryMonitoringEnabled = true
     }
 
-    @objc func addWatcher(_ call: CAPPluginCall) {
+    @objc func start(_ call: CAPPluginCall) {
         call.keepAlive = true
 
         // CLLocationManager requires main thread
         DispatchQueue.main.async {
+            // Check if already started
+            if self.locationManager != nil {
+                return call.reject("Location tracking already started", "ALREADY_STARTED")
+            }
+            // Create fresh location manager and initialize date
+            self.locationManager = CLLocationManager()
+            self.locationManager!.delegate = self
+            self.created = Date()
+
             let background = call.getString("backgroundMessage") != nil
-            let watcher = Watcher(
-                call.callbackId,
-                stale: call.getBool("stale") ?? false
-            )
-            let manager = watcher.locationManager
-            manager.delegate = self
+            self.allowStale = call.getBool("stale") ?? false
+            self.activeCallbackId = call.callbackId
+
             let externalPower = [
                 .full,
                 .charging
             ].contains(UIDevice.current.batteryState)
-            manager.desiredAccuracy = (
+            self.locationManager!.desiredAccuracy = (
                 externalPower
                     ? kCLLocationAccuracyBestForNavigation
                     : kCLLocationAccuracyBest
@@ -100,11 +78,11 @@ public class BackgroundGeolocation: CAPPlugin, CLLocationManagerDelegate {
             if distanceFilter == nil || distanceFilter == 0 {
                 distanceFilter = kCLDistanceFilterNone
             }
-            manager.distanceFilter = distanceFilter!
-            manager.allowsBackgroundLocationUpdates = background
-            manager.showsBackgroundLocationIndicator = background
-            manager.pausesLocationUpdatesAutomatically = false
-            self.watchers.append(watcher)
+            self.locationManager!.distanceFilter = distanceFilter!
+            self.locationManager!.allowsBackgroundLocationUpdates = background
+            self.locationManager!.showsBackgroundLocationIndicator = background
+            self.locationManager!.pausesLocationUpdatesAutomatically = false
+
             if call.getBool("requestPermissions") != false {
                 let status = CLLocationManager.authorizationStatus()
                 if [
@@ -114,35 +92,35 @@ public class BackgroundGeolocation: CAPPlugin, CLLocationManagerDelegate {
                 ].contains(status) {
                     return (
                         background
-                            ? manager.requestAlwaysAuthorization()
-                            : manager.requestWhenInUseAuthorization()
+                            ? self.locationManager!.requestAlwaysAuthorization()
+                            : self.locationManager!.requestWhenInUseAuthorization()
                     )
                 }
                 if background && status == .authorizedWhenInUse {
                     // Attempt to escalate.
-                    manager.requestAlwaysAuthorization()
+                    self.locationManager!.requestAlwaysAuthorization()
                 }
             }
-            return watcher.start()
+            return self.startUpdatingLocation()
         }
     }
 
-    @objc func removeWatcher(_ call: CAPPluginCall) {
+    @objc func stop(_ call: CAPPluginCall) {
         // CLLocationManager requires main thread
         DispatchQueue.main.async {
-            if let callbackId = call.getString("id") {
-                if let index = self.watchers.firstIndex(
-                    where: { $0.callbackId == callbackId }
-                ) {
-                    self.watchers[index].locationManager.stopUpdatingLocation()
-                    self.watchers.remove(at: index)
-                }
+            self.stopUpdatingLocation()
+
+            self.locationManager?.delegate = nil
+            self.locationManager = nil
+            self.created = nil
+
+            if let callbackId = self.activeCallbackId {
                 if let savedCall = self.bridge?.savedCall(withID: callbackId) {
                     self.bridge?.releaseCall(savedCall)
                 }
-                return call.resolve()
+                self.activeCallbackId = nil
             }
-            return call.reject("No callback ID")
+            return call.resolve()
         }
     }
 
@@ -169,46 +147,67 @@ public class BackgroundGeolocation: CAPPlugin, CLLocationManagerDelegate {
         }
     }
 
+    private func startUpdatingLocation() {
+        // Avoid unnecessary calls to startUpdatingLocation, which can
+        // result in extraneous invocations of didFailWithError.
+        if !isUpdatingLocation, let manager = locationManager {
+            manager.startUpdatingLocation()
+            isUpdatingLocation = true
+        }
+    }
+
+    private func stopUpdatingLocation() {
+        if isUpdatingLocation, let manager = locationManager {
+            manager.stopUpdatingLocation()
+            isUpdatingLocation = false
+        }
+    }
+
+    private func isLocationValid(_ location: CLLocation) -> Bool {
+        guard let created = created else { return allowStale }
+        return (
+            allowStale ||
+                location.timestamp >= created
+        )
+    }
+
     public func locationManager(
         _ manager: CLLocationManager,
         didFailWithError error: Error
     ) {
-        if let watcher = self.watchers.first(
-            where: { $0.locationManager == manager }
-        ) {
-            if let call = self.bridge?.savedCall(withID: watcher.callbackId) {
-                if let clErr = error as? CLError {
-                    if clErr.code == .locationUnknown {
-                        // This error is sometimes sent by the manager if
-                        // it cannot get a fix immediately.
-                        return
-                    } else if clErr.code == .denied {
-                        watcher.stop()
-                        return call.reject(
-                            "Permission denied.",
-                            "NOT_AUTHORIZED"
-                        )
-                    }
-                }
-                return call.reject(error.localizedDescription, nil, error)
+        guard let callbackId = activeCallbackId,
+              let call = self.bridge?.savedCall(withID: callbackId) else {
+            return
+        }
+
+        if let clErr = error as? CLError {
+            if clErr.code == .locationUnknown {
+                // This error is sometimes sent by the manager if
+                // it cannot get a fix immediately.
+                return
+            } else if clErr.code == .denied {
+                stopUpdatingLocation()
+                return call.reject(
+                    "Permission denied.",
+                    "NOT_AUTHORIZED"
+                )
             }
         }
+        return call.reject(error.localizedDescription, nil, error)
     }
 
     public func locationManager(
         _ manager: CLLocationManager,
         didUpdateLocations locations: [CLLocation]
     ) {
-        if let location = locations.last {
-            if let watcher = self.watchers.first(
-                where: { $0.locationManager == manager }
-            ) {
-                if watcher.isLocationValid(location) {
-                    if let call = self.bridge?.savedCall(withID: watcher.callbackId) {
-                        return call.resolve(formatLocation(location))
-                    }
-                }
-            }
+        guard let location = locations.last,
+              let callbackId = activeCallbackId,
+              let call = self.bridge?.savedCall(withID: callbackId) else {
+            return
+        }
+
+        if isLocationValid(location) {
+            return call.resolve(formatLocation(location))
         }
     }
 
@@ -220,11 +219,7 @@ public class BackgroundGeolocation: CAPPlugin, CLLocationManagerDelegate {
         // it is on iOS 14 when the permissions dialog is presented, we ignore
         // it.
         if status != .notDetermined {
-            if let watcher = self.watchers.first(
-                where: { $0.locationManager == manager }
-            ) {
-                return watcher.start()
-            }
+            startUpdatingLocation()
         }
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@capgo/background-geolocation",
-    "version": "7.0.8",
+    "version": "7.0.9",
     "description": "Receive geolocation updates even while the app is in the background.",
     "main": "dist/plugin.cjs.js",
     "module": "dist/esm/index.js",