@capgo/background-geolocation 8.0.31 → 8.0.33

package/dist/esm/definitions.d.ts

@@ -1,3 +1,4 @@
+import type { PluginListenerHandle } from '@capacitor/core';
 /**
  * The options for configuring for location updates.
  *
@@ -190,6 +191,231 @@ export interface SetPlannedRouteOptions {
      */
     distance: number;
 }
+/**
+ * Options for configuring native geofence transition handling.
+ *
+ * When `url` is provided, native iOS and Android code sends a JSON `POST`
+ * whenever a monitored region is entered or exited. This keeps geofence
+ * handling useful when the WebView is suspended.
+ *
+ * @since 8.0.30
+ */
+export interface GeofenceSetupOptions {
+    /**
+     * Endpoint that receives geofence transition payloads.
+     *
+     * @since 8.0.30
+     * @example "https://api.example.com/geofences"
+     */
+    url?: string;
+    /**
+     * Whether entry transitions should be monitored.
+     *
+     * @since 8.0.30
+     * @default true
+     * @example true
+     */
+    notifyOnEntry?: boolean;
+    /**
+     * Whether exit transitions should be monitored.
+     *
+     * @since 8.0.30
+     * @default true
+     * @example true
+     */
+    notifyOnExit?: boolean;
+    /**
+     * Base JSON payload merged into every native transition POST and listener event.
+     *
+     * @since 8.0.30
+     * @example { "userId": "123" }
+     */
+    payload?: Record<string, unknown>;
+    /**
+     * Whether the plugin should request the native location permission needed for geofencing.
+     *
+     * iOS geofencing needs Always location authorization. Android background geofencing
+     * needs foreground location and, on Android 10+, background location permission.
+     *
+     * @since 8.0.30
+     * @default true
+     * @example true
+     */
+    requestPermissions?: boolean;
+}
+/**
+ * A circular geofence region.
+ *
+ * @since 8.0.30
+ */
+export interface AddGeofenceOptions {
+    /**
+     * Latitude in degrees for the region center.
+     *
+     * @since 8.0.30
+     * @example 40.7128
+     */
+    latitude: number;
+    /**
+     * Longitude in degrees for the region center.
+     *
+     * @since 8.0.30
+     * @example -74.006
+     */
+    longitude: number;
+    /**
+     * Region radius in meters.
+     *
+     * @since 8.0.30
+     * @default 50
+     * @example 150
+     */
+    radius?: number;
+    /**
+     * Stable identifier for the geofence.
+     *
+     * @since 8.0.30
+     * @example "office"
+     */
+    identifier: string;
+    /**
+     * Overrides the setup-level entry setting for this region.
+     *
+     * @since 8.0.30
+     */
+    notifyOnEntry?: boolean;
+    /**
+     * Overrides the setup-level exit setting for this region.
+     *
+     * @since 8.0.30
+     */
+    notifyOnExit?: boolean;
+    /**
+     * Region-specific payload merged over the setup payload.
+     *
+     * @since 8.0.30
+     * @example { "storeId": "nyc-1" }
+     */
+    payload?: Record<string, unknown>;
+}
+/**
+ * Options for removing a monitored geofence.
+ *
+ * @since 8.0.30
+ */
+export interface RemoveGeofenceOptions {
+    /**
+     * Identifier passed to `addGeofence`.
+     *
+     * @since 8.0.30
+     * @example "office"
+     */
+    identifier: string;
+}
+/**
+ * Result returned when listing monitored geofences.
+ *
+ * @since 8.0.30
+ */
+export interface MonitoredGeofencesResult {
+    /**
+     * Identifiers for all geofences currently monitored by this plugin.
+     *
+     * @since 8.0.30
+     * @example ["office", "warehouse"]
+     */
+    regions: string[];
+}
+/**
+ * Event emitted when a monitored geofence is entered or exited.
+ *
+ * The same data is also sent to the configured `url`, when one is set.
+ *
+ * @since 8.0.30
+ */
+export interface GeofenceTransitionEvent {
+    /**
+     * Identifier of the geofence that changed state.
+     *
+     * @since 8.0.30
+     * @example "office"
+     */
+    identifier: string;
+    /**
+     * Transition name.
+     *
+     * @since 8.0.30
+     * @example "enter"
+     */
+    transition: 'enter' | 'exit';
+    /**
+     * `true` for entry transitions, `false` for exit transitions.
+     *
+     * @since 8.0.30
+     * @example true
+     */
+    enter: boolean;
+    /**
+     * Latitude in degrees for the monitored region center, when available.
+     *
+     * @since 8.0.30
+     * @example 40.7128
+     */
+    latitude?: number;
+    /**
+     * Longitude in degrees for the monitored region center, when available.
+     *
+     * @since 8.0.30
+     * @example -74.006
+     */
+    longitude?: number;
+    /**
+     * Region radius in meters, when available.
+     *
+     * @since 8.0.30
+     * @example 150
+     */
+    radius?: number;
+    /**
+     * Merged setup and region payload.
+     *
+     * @since 8.0.30
+     */
+    payload?: Record<string, unknown>;
+}
+/**
+ * Event emitted when native geofence monitoring fails.
+ *
+ * @since 8.0.30
+ */
+export interface GeofenceErrorEvent {
+    /**
+     * Identifier of the geofence that failed, when native APIs provide it.
+     *
+     * @since 8.0.30
+     * @example "office"
+     */
+    identifier?: string;
+    /**
+     * Native platform error code.
+     *
+     * @since 8.0.30
+     * @example 5
+     */
+    code?: number;
+    /**
+     * Native platform error message.
+     *
+     * @since 8.0.30
+     */
+    message: string;
+    /**
+     * Native error domain, when available.
+     *
+     * @since 8.0.30
+     */
+    domain?: string;
+}
 /**
  * Main plugin interface for background geolocation functionality.
  * Provides methods to manage location updates and access device settings.
@@ -265,6 +491,97 @@ export interface BackgroundGeolocationPlugin {
      * });
      */
     setPlannedRoute(options: SetPlannedRouteOptions): Promise<void>;
+    /**
+     * Configures native geofence transition handling.
+     *
+     * Call this before adding geofences when you need native background POSTs
+     * or default entry/exit settings.
+     *
+     * @param options The geofence configuration options
+     * @returns A promise that resolves once geofencing is configured
+     *
+     * @since 8.0.30
+     * @example
+     * await BackgroundGeolocation.setupGeofencing({
+     *   url: "https://api.example.com/geofences",
+     *   notifyOnEntry: true,
+     *   notifyOnExit: true,
+     *   payload: { userId: "123" }
+     * });
+     */
+    setupGeofencing(options: GeofenceSetupOptions): Promise<void>;
+    /**
+     * Starts monitoring a circular native geofence.
+     *
+     * @param options The geofence region options
+     * @returns A promise that resolves when native monitoring starts
+     *
+     * @since 8.0.30
+     * @example
+     * await BackgroundGeolocation.addGeofence({
+     *   identifier: "office",
+     *   latitude: 40.7128,
+     *   longitude: -74.006,
+     *   radius: 150
+     * });
+     */
+    addGeofence(options: AddGeofenceOptions): Promise<void>;
+    /**
+     * Stops monitoring one geofence.
+     *
+     * @param options The geofence identifier
+     * @returns A promise that resolves when native monitoring stops
+     *
+     * @since 8.0.30
+     * @example
+     * await BackgroundGeolocation.removeGeofence({ identifier: "office" });
+     */
+    removeGeofence(options: RemoveGeofenceOptions): Promise<void>;
+    /**
+     * Stops monitoring every geofence registered by this plugin.
+     *
+     * @returns A promise that resolves when all native geofences are removed
+     *
+     * @since 8.0.30
+     * @example
+     * await BackgroundGeolocation.removeAllGeofences();
+     */
+    removeAllGeofences(): Promise<void>;
+    /**
+     * Lists the geofence identifiers currently monitored by this plugin.
+     *
+     * @returns A promise with monitored geofence identifiers
+     *
+     * @since 8.0.30
+     * @example
+     * const { regions } = await BackgroundGeolocation.getMonitoredGeofences();
+     */
+    getMonitoredGeofences(): Promise<MonitoredGeofencesResult>;
+    /**
+     * Listens for geofence enter/exit transitions while the WebView is alive.
+     *
+     * Native `url` delivery configured through `setupGeofencing` is used for
+     * background-safe delivery.
+     *
+     * @since 8.0.30
+     * @example
+     * const handle = await BackgroundGeolocation.addListener(
+     *   "geofenceTransition",
+     *   (event) => console.log(event.identifier, event.transition)
+     * );
+     */
+    addListener(eventName: 'geofenceTransition', listenerFunc: (event: GeofenceTransitionEvent) => void): Promise<PluginListenerHandle>;
+    /**
+     * Listens for native geofence monitoring errors while the WebView is alive.
+     *
+     * @since 8.0.30
+     * @example
+     * const handle = await BackgroundGeolocation.addListener(
+     *   "geofenceError",
+     *   (event) => console.error(event.identifier, event.message)
+     * );
+     */
+    addListener(eventName: 'geofenceError', listenerFunc: (event: GeofenceErrorEvent) => void): Promise<PluginListenerHandle>;
     /**
      * Get the native Capacitor plugin version
      *

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 for location updates.\n *\n * @since 7.0.9\n */\nexport interface StartOptions {\n  /**\n   * If the \"backgroundMessage\" option is defined, the plugin 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 7.0.9\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 7.0.9\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 7.0.9\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 7.0.9\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 7.0.9\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 7.0.0\n */\nexport interface Location {\n  /**\n   * Latitude in degrees.\n   * Range: -90.0 to +90.0\n   *\n   * @since 7.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 7.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 7.0.0\n   * @example 5.0\n   */\n  accuracy: number;\n  /**\n   * Metres above sea level (or null if not available).\n   *\n   * @since 7.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 7.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 7.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 7.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 7.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 7.0.0\n   * @example 1640995200000\n   */\n  time: number | null;\n}\n\n/**\n * Error object that may be passed to the location start callback.\n * Extends the standard Error with optional error codes.\n *\n * @since 7.0.0\n */\nexport interface CallbackError extends Error {\n  /**\n   * Optional error code for more specific error handling.\n   *\n   * @since 7.0.0\n   * @example \"PERMISSION_DENIED\"\n   */\n  code?: string;\n}\n\nexport interface SetPlannedRouteOptions {\n  /**\n   * The name of the sound file to play.\n   * Must be a valid sound relative path in the app's public folder to work for both web and native platforms.\n   * There's no need to include the public folder in the path.\n   * @since 7.0.10\n   * @example \"notification.mp3\"\n   * */\n  soundFile: string;\n  /**\n   * The planned route as an array of longitude and latitude pairs.\n   * Each pair represents a point on the route.\n   * This is used to define a route that the user can follow.\n   * The route is used to play a sound when the user deviates from it.\n   * @since 7.0.11\n   * @example [[-74.0060, 40.7128], [-118.2437, 34.0522]]\n   */\n  route: [number, number][];\n\n  /**\n   * The distance in meters that the user must deviate from the planned route to trigger the sound.\n   * This is used to determine how far off the route the user can be before the sound is played.\n   * If not specified, a default value of 50 meters is used.\n   * @since 7.0.11\n   * @default 50\n   * @example 50\n   */\n  distance: number;\n}\n\n/**\n * Main plugin interface for background geolocation functionality.\n * Provides methods to manage location updates and access device settings.\n *\n * @since 7.0.0\n */\nexport interface BackgroundGeolocationPlugin {\n  /**\n   * To start listening for changes in the device's location, call this method.\n   * A Promise is returned to indicate that it finished the call. The callback will be called every time a new location\n   * is available, or if there was an error when calling this method. Don't rely on promise rejection for this.\n   *\n   * @param options The 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 when the method is successfully called\n   *\n   * @since 7.0.9\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(options: StartOptions, callback: (position?: Location, error?: CallbackError) => void): Promise<void>;\n\n  /**\n   * Stops location updates.\n   *\n   * @returns A promise that resolves when the plugin stops successfully removed\n   *\n   * @since 7.0.9\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 7.0.0\n   * @example\n   * // Direct user to location settings\n   * await BackgroundGeolocation.openSettings();\n   */\n  openSettings(): Promise<void>;\n\n  /**\n   * Plays a sound file when the user deviates from the planned route.\n   * This should be used to play a sound (in the background too, only for native).\n   *\n   * @param options The options for setting the planned route and sound file\n   * @returns A promise that resolves when the route is set successfully\n   *\n   * @since 7.0.11\n   * @example\n   * await BackgroundGeolocation.setPlannedRoute({\n   *   soundFile: \"notification.mp3\",\n   *   route: [[-74.0060, 40.7128], [-118.2437, 34.0522]]\n   * });\n   */\n  setPlannedRoute(options: SetPlannedRouteOptions): Promise<void>;\n\n  /**\n   * Get the native Capacitor plugin version\n   *\n   * @returns {Promise<{ id: string }>} an Promise with version for this device\n   * @throws An error if the something went wrong\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\n/**\n * The options for configuring for location updates.\n *\n * @since 7.0.9\n */\nexport interface StartOptions {\n  /**\n   * If the \"backgroundMessage\" option is defined, the plugin 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 7.0.9\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 7.0.9\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 7.0.9\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 7.0.9\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 7.0.9\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 7.0.0\n */\nexport interface Location {\n  /**\n   * Latitude in degrees.\n   * Range: -90.0 to +90.0\n   *\n   * @since 7.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 7.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 7.0.0\n   * @example 5.0\n   */\n  accuracy: number;\n  /**\n   * Metres above sea level (or null if not available).\n   *\n   * @since 7.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 7.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 7.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 7.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 7.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 7.0.0\n   * @example 1640995200000\n   */\n  time: number | null;\n}\n\n/**\n * Error object that may be passed to the location start callback.\n * Extends the standard Error with optional error codes.\n *\n * @since 7.0.0\n */\nexport interface CallbackError extends Error {\n  /**\n   * Optional error code for more specific error handling.\n   *\n   * @since 7.0.0\n   * @example \"PERMISSION_DENIED\"\n   */\n  code?: string;\n}\n\nexport interface SetPlannedRouteOptions {\n  /**\n   * The name of the sound file to play.\n   * Must be a valid sound relative path in the app's public folder to work for both web and native platforms.\n   * There's no need to include the public folder in the path.\n   * @since 7.0.10\n   * @example \"notification.mp3\"\n   * */\n  soundFile: string;\n  /**\n   * The planned route as an array of longitude and latitude pairs.\n   * Each pair represents a point on the route.\n   * This is used to define a route that the user can follow.\n   * The route is used to play a sound when the user deviates from it.\n   * @since 7.0.11\n   * @example [[-74.0060, 40.7128], [-118.2437, 34.0522]]\n   */\n  route: [number, number][];\n\n  /**\n   * The distance in meters that the user must deviate from the planned route to trigger the sound.\n   * This is used to determine how far off the route the user can be before the sound is played.\n   * If not specified, a default value of 50 meters is used.\n   * @since 7.0.11\n   * @default 50\n   * @example 50\n   */\n  distance: number;\n}\n\n/**\n * Options for configuring native geofence transition handling.\n *\n * When `url` is provided, native iOS and Android code sends a JSON `POST`\n * whenever a monitored region is entered or exited. This keeps geofence\n * handling useful when the WebView is suspended.\n *\n * @since 8.0.30\n */\nexport interface GeofenceSetupOptions {\n  /**\n   * Endpoint that receives geofence transition payloads.\n   *\n   * @since 8.0.30\n   * @example \"https://api.example.com/geofences\"\n   */\n  url?: string;\n\n  /**\n   * Whether entry transitions should be monitored.\n   *\n   * @since 8.0.30\n   * @default true\n   * @example true\n   */\n  notifyOnEntry?: boolean;\n\n  /**\n   * Whether exit transitions should be monitored.\n   *\n   * @since 8.0.30\n   * @default true\n   * @example true\n   */\n  notifyOnExit?: boolean;\n\n  /**\n   * Base JSON payload merged into every native transition POST and listener event.\n   *\n   * @since 8.0.30\n   * @example { \"userId\": \"123\" }\n   */\n  payload?: Record<string, unknown>;\n\n  /**\n   * Whether the plugin should request the native location permission needed for geofencing.\n   *\n   * iOS geofencing needs Always location authorization. Android background geofencing\n   * needs foreground location and, on Android 10+, background location permission.\n   *\n   * @since 8.0.30\n   * @default true\n   * @example true\n   */\n  requestPermissions?: boolean;\n}\n\n/**\n * A circular geofence region.\n *\n * @since 8.0.30\n */\nexport interface AddGeofenceOptions {\n  /**\n   * Latitude in degrees for the region center.\n   *\n   * @since 8.0.30\n   * @example 40.7128\n   */\n  latitude: number;\n\n  /**\n   * Longitude in degrees for the region center.\n   *\n   * @since 8.0.30\n   * @example -74.006\n   */\n  longitude: number;\n\n  /**\n   * Region radius in meters.\n   *\n   * @since 8.0.30\n   * @default 50\n   * @example 150\n   */\n  radius?: number;\n\n  /**\n   * Stable identifier for the geofence.\n   *\n   * @since 8.0.30\n   * @example \"office\"\n   */\n  identifier: string;\n\n  /**\n   * Overrides the setup-level entry setting for this region.\n   *\n   * @since 8.0.30\n   */\n  notifyOnEntry?: boolean;\n\n  /**\n   * Overrides the setup-level exit setting for this region.\n   *\n   * @since 8.0.30\n   */\n  notifyOnExit?: boolean;\n\n  /**\n   * Region-specific payload merged over the setup payload.\n   *\n   * @since 8.0.30\n   * @example { \"storeId\": \"nyc-1\" }\n   */\n  payload?: Record<string, unknown>;\n}\n\n/**\n * Options for removing a monitored geofence.\n *\n * @since 8.0.30\n */\nexport interface RemoveGeofenceOptions {\n  /**\n   * Identifier passed to `addGeofence`.\n   *\n   * @since 8.0.30\n   * @example \"office\"\n   */\n  identifier: string;\n}\n\n/**\n * Result returned when listing monitored geofences.\n *\n * @since 8.0.30\n */\nexport interface MonitoredGeofencesResult {\n  /**\n   * Identifiers for all geofences currently monitored by this plugin.\n   *\n   * @since 8.0.30\n   * @example [\"office\", \"warehouse\"]\n   */\n  regions: string[];\n}\n\n/**\n * Event emitted when a monitored geofence is entered or exited.\n *\n * The same data is also sent to the configured `url`, when one is set.\n *\n * @since 8.0.30\n */\nexport interface GeofenceTransitionEvent {\n  /**\n   * Identifier of the geofence that changed state.\n   *\n   * @since 8.0.30\n   * @example \"office\"\n   */\n  identifier: string;\n\n  /**\n   * Transition name.\n   *\n   * @since 8.0.30\n   * @example \"enter\"\n   */\n  transition: 'enter' | 'exit';\n\n  /**\n   * `true` for entry transitions, `false` for exit transitions.\n   *\n   * @since 8.0.30\n   * @example true\n   */\n  enter: boolean;\n\n  /**\n   * Latitude in degrees for the monitored region center, when available.\n   *\n   * @since 8.0.30\n   * @example 40.7128\n   */\n  latitude?: number;\n\n  /**\n   * Longitude in degrees for the monitored region center, when available.\n   *\n   * @since 8.0.30\n   * @example -74.006\n   */\n  longitude?: number;\n\n  /**\n   * Region radius in meters, when available.\n   *\n   * @since 8.0.30\n   * @example 150\n   */\n  radius?: number;\n\n  /**\n   * Merged setup and region payload.\n   *\n   * @since 8.0.30\n   */\n  payload?: Record<string, unknown>;\n}\n\n/**\n * Event emitted when native geofence monitoring fails.\n *\n * @since 8.0.30\n */\nexport interface GeofenceErrorEvent {\n  /**\n   * Identifier of the geofence that failed, when native APIs provide it.\n   *\n   * @since 8.0.30\n   * @example \"office\"\n   */\n  identifier?: string;\n\n  /**\n   * Native platform error code.\n   *\n   * @since 8.0.30\n   * @example 5\n   */\n  code?: number;\n\n  /**\n   * Native platform error message.\n   *\n   * @since 8.0.30\n   */\n  message: string;\n\n  /**\n   * Native error domain, when available.\n   *\n   * @since 8.0.30\n   */\n  domain?: string;\n}\n\n/**\n * Main plugin interface for background geolocation functionality.\n * Provides methods to manage location updates and access device settings.\n *\n * @since 7.0.0\n */\nexport interface BackgroundGeolocationPlugin {\n  /**\n   * To start listening for changes in the device's location, call this method.\n   * A Promise is returned to indicate that it finished the call. The callback will be called every time a new location\n   * is available, or if there was an error when calling this method. Don't rely on promise rejection for this.\n   *\n   * @param options The 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 when the method is successfully called\n   *\n   * @since 7.0.9\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(options: StartOptions, callback: (position?: Location, error?: CallbackError) => void): Promise<void>;\n\n  /**\n   * Stops location updates.\n   *\n   * @returns A promise that resolves when the plugin stops successfully removed\n   *\n   * @since 7.0.9\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 7.0.0\n   * @example\n   * // Direct user to location settings\n   * await BackgroundGeolocation.openSettings();\n   */\n  openSettings(): Promise<void>;\n\n  /**\n   * Plays a sound file when the user deviates from the planned route.\n   * This should be used to play a sound (in the background too, only for native).\n   *\n   * @param options The options for setting the planned route and sound file\n   * @returns A promise that resolves when the route is set successfully\n   *\n   * @since 7.0.11\n   * @example\n   * await BackgroundGeolocation.setPlannedRoute({\n   *   soundFile: \"notification.mp3\",\n   *   route: [[-74.0060, 40.7128], [-118.2437, 34.0522]]\n   * });\n   */\n  setPlannedRoute(options: SetPlannedRouteOptions): Promise<void>;\n\n  /**\n   * Configures native geofence transition handling.\n   *\n   * Call this before adding geofences when you need native background POSTs\n   * or default entry/exit settings.\n   *\n   * @param options The geofence configuration options\n   * @returns A promise that resolves once geofencing is configured\n   *\n   * @since 8.0.30\n   * @example\n   * await BackgroundGeolocation.setupGeofencing({\n   *   url: \"https://api.example.com/geofences\",\n   *   notifyOnEntry: true,\n   *   notifyOnExit: true,\n   *   payload: { userId: \"123\" }\n   * });\n   */\n  setupGeofencing(options: GeofenceSetupOptions): Promise<void>;\n\n  /**\n   * Starts monitoring a circular native geofence.\n   *\n   * @param options The geofence region options\n   * @returns A promise that resolves when native monitoring starts\n   *\n   * @since 8.0.30\n   * @example\n   * await BackgroundGeolocation.addGeofence({\n   *   identifier: \"office\",\n   *   latitude: 40.7128,\n   *   longitude: -74.006,\n   *   radius: 150\n   * });\n   */\n  addGeofence(options: AddGeofenceOptions): Promise<void>;\n\n  /**\n   * Stops monitoring one geofence.\n   *\n   * @param options The geofence identifier\n   * @returns A promise that resolves when native monitoring stops\n   *\n   * @since 8.0.30\n   * @example\n   * await BackgroundGeolocation.removeGeofence({ identifier: \"office\" });\n   */\n  removeGeofence(options: RemoveGeofenceOptions): Promise<void>;\n\n  /**\n   * Stops monitoring every geofence registered by this plugin.\n   *\n   * @returns A promise that resolves when all native geofences are removed\n   *\n   * @since 8.0.30\n   * @example\n   * await BackgroundGeolocation.removeAllGeofences();\n   */\n  removeAllGeofences(): Promise<void>;\n\n  /**\n   * Lists the geofence identifiers currently monitored by this plugin.\n   *\n   * @returns A promise with monitored geofence identifiers\n   *\n   * @since 8.0.30\n   * @example\n   * const { regions } = await BackgroundGeolocation.getMonitoredGeofences();\n   */\n  getMonitoredGeofences(): Promise<MonitoredGeofencesResult>;\n\n  /**\n   * Listens for geofence enter/exit transitions while the WebView is alive.\n   *\n   * Native `url` delivery configured through `setupGeofencing` is used for\n   * background-safe delivery.\n   *\n   * @since 8.0.30\n   * @example\n   * const handle = await BackgroundGeolocation.addListener(\n   *   \"geofenceTransition\",\n   *   (event) => console.log(event.identifier, event.transition)\n   * );\n   */\n  addListener(\n    eventName: 'geofenceTransition',\n    listenerFunc: (event: GeofenceTransitionEvent) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Listens for native geofence monitoring errors while the WebView is alive.\n   *\n   * @since 8.0.30\n   * @example\n   * const handle = await BackgroundGeolocation.addListener(\n   *   \"geofenceError\",\n   *   (event) => console.error(event.identifier, event.message)\n   * );\n   */\n  addListener(\n    eventName: 'geofenceError',\n    listenerFunc: (event: GeofenceErrorEvent) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Get the native Capacitor plugin version\n   *\n   * @returns {Promise<{ id: string }>} an Promise with version for this device\n   * @throws An error if the something went wrong\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n}\n"]}

package/dist/esm/web.d.ts

@@ -1,16 +1,32 @@
 import { WebPlugin } from '@capacitor/core';
-import type { BackgroundGeolocationPlugin, StartOptions, Location, CallbackError, SetPlannedRouteOptions } from './definitions';
+import type { BackgroundGeolocationPlugin, StartOptions, Location, CallbackError, SetPlannedRouteOptions, GeofenceSetupOptions, AddGeofenceOptions, RemoveGeofenceOptions, MonitoredGeofencesResult } from './definitions';
 export declare class BackgroundGeolocationWeb extends WebPlugin implements BackgroundGeolocationPlugin {
     private static readonly EARTH_RADIUS_M;
     private watchId;
+    private geofenceWatchId;
     private plannedRoute;
     private audio;
     private isOffRoute;
     private distanceThreshold;
+    private geofences;
+    private geofenceUrl;
+    private geofencePayload;
+    private notifyOnEntry;
+    private notifyOnExit;
     start(options: StartOptions, callback: (position?: Location, error?: CallbackError) => void): Promise<void>;
     stop(): Promise<void>;
     openSettings(): Promise<void>;
     setPlannedRoute(options: SetPlannedRouteOptions): Promise<void>;
+    setupGeofencing(options: GeofenceSetupOptions): Promise<void>;
+    addGeofence(options: AddGeofenceOptions): Promise<void>;
+    removeGeofence(options: RemoveGeofenceOptions): Promise<void>;
+    removeAllGeofences(): Promise<void>;
+    getMonitoredGeofences(): Promise<MonitoredGeofencesResult>;
+    private validateGeofence;
+    private startGeofenceWatch;
+    private stopGeofenceWatchIfIdle;
+    private checkGeofences;
+    private emitGeofenceTransition;
     private toRadians;
     private haversine;
     private distancePointToLineSegment;

package/dist/esm/web.js

@@ -5,6 +5,10 @@ export class BackgroundGeolocationWeb extends WebPlugin {
         this.plannedRoute = [];
         this.isOffRoute = true;
         this.distanceThreshold = 50;
+        this.geofences = new Map();
+        this.geofencePayload = {};
+        this.notifyOnEntry = true;
+        this.notifyOnExit = true;
     }
     async start(options, callback) {
         if (!navigator.geolocation) {
@@ -43,6 +47,7 @@ export class BackgroundGeolocationWeb extends WebPlugin {
                 }
                 this.isOffRoute = offRoute;
             }
+            this.checkGeofences(position.coords.latitude, position.coords.longitude);
             callback(location);
         }, (error) => {
             const callbackError = {
@@ -80,6 +85,109 @@ export class BackgroundGeolocationWeb extends WebPlugin {
         this.plannedRoute = options.route || [];
         this.distanceThreshold = options.distance || 50;
     }
+    async setupGeofencing(options) {
+        var _a, _b, _c;
+        if (options.url) {
+            new URL(options.url);
+        }
+        this.geofenceUrl = options.url;
+        this.notifyOnEntry = (_a = options.notifyOnEntry) !== null && _a !== void 0 ? _a : true;
+        this.notifyOnExit = (_b = options.notifyOnExit) !== null && _b !== void 0 ? _b : true;
+        this.geofencePayload = (_c = options.payload) !== null && _c !== void 0 ? _c : {};
+    }
+    async addGeofence(options) {
+        var _a, _b, _c, _d;
+        if (!navigator.geolocation) {
+            throw new Error('Geolocation is not supported by this browser');
+        }
+        this.validateGeofence(options.latitude, options.longitude, (_a = options.radius) !== null && _a !== void 0 ? _a : 50, options.identifier);
+        this.geofences.set(options.identifier, {
+            latitude: options.latitude,
+            longitude: options.longitude,
+            radius: (_b = options.radius) !== null && _b !== void 0 ? _b : 50,
+            identifier: options.identifier,
+            notifyOnEntry: (_c = options.notifyOnEntry) !== null && _c !== void 0 ? _c : this.notifyOnEntry,
+            notifyOnExit: (_d = options.notifyOnExit) !== null && _d !== void 0 ? _d : this.notifyOnExit,
+            payload: options.payload,
+        });
+        this.startGeofenceWatch();
+    }
+    async removeGeofence(options) {
+        if (!options.identifier) {
+            throw new Error('Identifier is required');
+        }
+        this.geofences.delete(options.identifier);
+        this.stopGeofenceWatchIfIdle();
+    }
+    async removeAllGeofences() {
+        this.geofences.clear();
+        this.stopGeofenceWatchIfIdle();
+    }
+    async getMonitoredGeofences() {
+        return { regions: Array.from(this.geofences.keys()) };
+    }
+    validateGeofence(latitude, longitude, radius, identifier) {
+        if (!identifier) {
+            throw new Error('Identifier is required');
+        }
+        if (!Number.isFinite(latitude) || latitude < -90 || latitude > 90) {
+            throw new Error('Latitude must be between -90 and 90');
+        }
+        if (!Number.isFinite(longitude) || longitude < -180 || longitude > 180) {
+            throw new Error('Longitude must be between -180 and 180');
+        }
+        if (!Number.isFinite(radius) || radius <= 0) {
+            throw new Error('Radius must be greater than 0');
+        }
+    }
+    startGeofenceWatch() {
+        if (this.geofenceWatchId !== undefined || this.geofences.size === 0 || !navigator.geolocation) {
+            return;
+        }
+        this.geofenceWatchId = navigator.geolocation.watchPosition((position) => this.checkGeofences(position.coords.latitude, position.coords.longitude), () => undefined, {
+            enableHighAccuracy: false,
+            timeout: 30000,
+            maximumAge: 60000,
+        });
+    }
+    stopGeofenceWatchIfIdle() {
+        if (this.geofences.size > 0 || this.geofenceWatchId === undefined) {
+            return;
+        }
+        navigator.geolocation.clearWatch(this.geofenceWatchId);
+        this.geofenceWatchId = undefined;
+    }
+    checkGeofences(latitude, longitude) {
+        const point = [longitude, latitude];
+        this.geofences.forEach((geofence) => {
+            const distance = this.haversine(point, [geofence.longitude, geofence.latitude]);
+            const inside = distance <= geofence.radius;
+            const previousInside = geofence.inside;
+            geofence.inside = inside;
+            if (inside && previousInside !== true && geofence.notifyOnEntry) {
+                this.emitGeofenceTransition(geofence, true);
+            }
+            else if (!inside && previousInside === true && geofence.notifyOnExit) {
+                this.emitGeofenceTransition(geofence, false);
+            }
+        });
+    }
+    emitGeofenceTransition(geofence, enter) {
+        var _a;
+        const payload = Object.assign(Object.assign({}, this.geofencePayload), ((_a = geofence.payload) !== null && _a !== void 0 ? _a : {}));
+        const event = Object.assign(Object.assign({}, payload), { identifier: geofence.identifier, transition: enter ? 'enter' : 'exit', enter, latitude: geofence.latitude, longitude: geofence.longitude, radius: geofence.radius, payload });
+        void this.notifyListeners('geofenceTransition', event);
+        if (this.geofenceUrl) {
+            void fetch(this.geofenceUrl, {
+                method: 'POST',
+                headers: {
+                    Accept: 'application/json',
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(event),
+            }).catch(() => undefined);
+        }
+    }
     toRadians(degrees) {
         return (degrees * Math.PI) / 180;
     }

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;AAU5C,MAAM,OAAO,wBAAyB,SAAQ,SAAS;IAAvD;;QAIU,iBAAY,GAAuB,EAAE,CAAC;QAEtC,eAAU,GAAG,IAAI,CAAC;QAClB,sBAAiB,GAAG,EAAE,CAAC;IAiLjC,CAAC;IA/KC,KAAK,CAAC,KAAK,CAAC,OAAqB,EAAE,QAA8D;QAC/F,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,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/C,MAAM,YAAY,GAAqB,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAC7F,MAAM,QAAQ,GAAG,IAAI,CAAC,oBAAoB,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,iBAAiB,CAAC;gBAClF,IAAI,QAAQ,IAAI,IAAI,IAAI,IAAI,CAAC,UAAU,KAAK,KAAK,EAAE,CAAC;oBAClD,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBACpB,CAAC;gBACD,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC;YAC7B,CAAC;YACD,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;IAED,KAAK,CAAC,eAAe,CAAC,OAA+B;QACnD,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACnB,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,EAAE,CAAC;YACpB,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACzB,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QACxC,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;IAClD,CAAC;IAEO,SAAS,CAAC,OAAe;QAC/B,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;IACnC,CAAC;IAEO,SAAS,CAAC,MAAwB,EAAE,MAAwB;QAClE,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,MAAM,CAAC;QAC5B,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,MAAM,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;QAEzC,MAAM,CAAC,GACL,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;YACvC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;QAE5G,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAEzD,OAAO,wBAAwB,CAAC,cAAc,GAAG,CAAC,CAAC;IACrD,CAAC;IAEO,0BAA0B,CAChC,KAAuB,EACvB,SAA2B,EAC3B,OAAyB;QAEzB,mEAAmE;QACnE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAEpD,gEAAgE;QAChE,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;YACnB,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,kEAAkE;QAClE,2DAA2D;QAC3D,sCAAsC;QAEtC,yBAAyB;QACzB,gFAAgF;QAChF,MAAM,KAAK,GAAG,CAAC,QAAQ,IAAI,CAAC,GAAG,QAAQ,IAAI,CAAC,GAAG,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC3G,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,uBAAuB;QACvB,MAAM,KAAK,GAAG,CAAC,QAAQ,IAAI,CAAC,GAAG,QAAQ,IAAI,CAAC,GAAG,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC3G,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,6EAA6E;QAC7E,yEAAyE;QAEzE,sDAAsD;QACtD,MAAM,CAAC,GAAG,CAAC,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAE/C,8CAA8C;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAE1F,4EAA4E;QAC5E,2DAA2D;QAC3D,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC;IAEO,oBAAoB,CAAC,KAAuB;QAClD,gEAAgE;QAChE,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACnC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;YACrD,CAAC;YACD,OAAO,QAAQ,CAAC,CAAC,sCAAsC;QACzD,CAAC;QAED,IAAI,WAAW,GAAG,QAAQ,CAAC;QAE3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACtD,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACvC,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,0BAA0B,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YAC5E,IAAI,QAAQ,GAAG,WAAW,EAAE,CAAC;gBAC3B,WAAW,GAAG,QAAQ,CAAC;YACzB,CAAC;QACH,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;;AAtLuB,uCAAc,GAAG,OAAO,AAAV,CAAW","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type {\n  BackgroundGeolocationPlugin,\n  StartOptions,\n  Location,\n  CallbackError,\n  SetPlannedRouteOptions,\n} from './definitions';\n\nexport class BackgroundGeolocationWeb extends WebPlugin implements BackgroundGeolocationPlugin {\n  private static readonly EARTH_RADIUS_M = 6371000;\n\n  private watchId: number | undefined;\n  private plannedRoute: [number, number][] = [];\n  private audio: HTMLAudioElement | undefined;\n  private isOffRoute = true;\n  private distanceThreshold = 50;\n\n  async start(options: StartOptions, callback: (position?: Location, error?: CallbackError) => void): 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        if (this.audio && this.plannedRoute.length > 0) {\n          const currentPoint: [number, number] = [position.coords.longitude, position.coords.latitude];\n          const offRoute = this.distancePointToRoute(currentPoint) > this.distanceThreshold;\n          if (offRoute == true && this.isOffRoute === false) {\n            this.audio.play();\n          }\n          this.isOffRoute = offRoute;\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  async setPlannedRoute(options: SetPlannedRouteOptions): Promise<void> {\n    if (!options.soundFile) {\n      throw new Error('Sound file is required');\n    }\n    if (this.audio) {\n      this.audio.pause();\n      this.audio.src = '';\n      this.audio = undefined;\n    }\n    this.audio = new Audio(options.soundFile);\n    this.plannedRoute = options.route || [];\n    this.distanceThreshold = options.distance || 50;\n  }\n\n  private toRadians(degrees: number): number {\n    return (degrees * Math.PI) / 180;\n  }\n\n  private haversine(point1: [number, number], point2: [number, number]): number {\n    const [lon1, lat1] = point1;\n    const [lon2, lat2] = point2;\n    const dLat = this.toRadians(lat2 - lat1);\n    const dLon = this.toRadians(lon2 - lon1);\n\n    const a =\n      Math.sin(dLat / 2) * Math.sin(dLat / 2) +\n      Math.cos(this.toRadians(lat1)) * Math.cos(this.toRadians(lat2)) * Math.sin(dLon / 2) * Math.sin(dLon / 2);\n\n    const c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));\n\n    return BackgroundGeolocationWeb.EARTH_RADIUS_M * c;\n  }\n\n  private distancePointToLineSegment(\n    point: [number, number],\n    lineStart: [number, number],\n    lineEnd: [number, number],\n  ): number {\n    // Calculate the distances between the three points using Haversine\n    const dist_A_B = this.haversine(point, lineStart);\n    const dist_A_C = this.haversine(point, lineEnd);\n    const dist_B_C = this.haversine(lineStart, lineEnd);\n\n    // Handle the edge case where the line segment is a single point\n    if (dist_B_C === 0) {\n      return dist_A_B;\n    }\n\n    // Check if the angles at the line segment's endpoints are obtuse.\n    // We use the Law of Cosines (c^2 = a^2 + b^2 - 2ab*cos(C))\n    // If cos(C) < 0, the angle is obtuse.\n\n    // Angle at B (lineStart)\n    // Use a small epsilon to handle floating point inaccuracies in division by zero\n    const cos_B = (dist_A_B ** 2 + dist_B_C ** 2 - dist_A_C ** 2) / (2 * dist_A_B * dist_B_C + Number.EPSILON);\n    if (cos_B < 0) {\n      return dist_A_B;\n    }\n\n    // Angle at C (lineEnd)\n    const cos_C = (dist_A_C ** 2 + dist_B_C ** 2 - dist_A_B ** 2) / (2 * dist_A_C * dist_B_C + Number.EPSILON);\n    if (cos_C < 0) {\n      return dist_A_C;\n    }\n\n    // If both angles are acute, the closest point is on the line segment itself.\n    // We can calculate the distance (height of the triangle) using its area.\n\n    // 1. Calculate the semi-perimeter of the triangle ABC\n    const s = (dist_A_B + dist_A_C + dist_B_C) / 2;\n\n    // 2. Calculate the area using Heron's formula\n    const area = Math.sqrt(Math.max(0, s * (s - dist_A_B) * (s - dist_A_C) * (s - dist_B_C)));\n\n    // 3. The distance is the height of the triangle from point A to the base BC\n    // Area = 0.5 * base * height  =>  height = 2 * Area / base\n    return (2 * area) / (dist_B_C + Number.EPSILON);\n  }\n\n  private distancePointToRoute(point: [number, number]): number {\n    // If the route has less than 2 points, we can't form a segment.\n    if (this.plannedRoute.length < 2) {\n      if (this.plannedRoute.length === 1) {\n        return this.haversine(point, this.plannedRoute[0]);\n      }\n      return Infinity; // No line segments to measure against\n    }\n\n    let minDistance = Infinity;\n\n    for (let i = 0; i < this.plannedRoute.length - 1; i++) {\n      const lineStart = this.plannedRoute[i];\n      const lineEnd = this.plannedRoute[i + 1];\n      const distance = this.distancePointToLineSegment(point, lineStart, lineEnd);\n      if (distance < minDistance) {\n        minDistance = distance;\n      }\n    }\n\n    return minDistance;\n  }\n\n  async getPluginVersion(): Promise<{ version: string }> {\n    return { version: 'web' };\n  }\n}\n"]}
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"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","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type {\n  BackgroundGeolocationPlugin,\n  StartOptions,\n  Location,\n  CallbackError,\n  SetPlannedRouteOptions,\n  GeofenceSetupOptions,\n  AddGeofenceOptions,\n  RemoveGeofenceOptions,\n  MonitoredGeofencesResult,\n  GeofenceTransitionEvent,\n} from './definitions';\n\ninterface WebGeofence {\n  latitude: number;\n  longitude: number;\n  radius: number;\n  identifier: string;\n  notifyOnEntry: boolean;\n  notifyOnExit: boolean;\n  payload?: Record<string, unknown>;\n  inside?: boolean;\n}\n\nexport class BackgroundGeolocationWeb extends WebPlugin implements BackgroundGeolocationPlugin {\n  private static readonly EARTH_RADIUS_M = 6371000;\n\n  private watchId: number | undefined;\n  private geofenceWatchId: number | undefined;\n  private plannedRoute: [number, number][] = [];\n  private audio: HTMLAudioElement | undefined;\n  private isOffRoute = true;\n  private distanceThreshold = 50;\n  private geofences = new Map<string, WebGeofence>();\n  private geofenceUrl: string | undefined;\n  private geofencePayload: Record<string, unknown> = {};\n  private notifyOnEntry = true;\n  private notifyOnExit = true;\n\n  async start(options: StartOptions, callback: (position?: Location, error?: CallbackError) => void): 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        if (this.audio && this.plannedRoute.length > 0) {\n          const currentPoint: [number, number] = [position.coords.longitude, position.coords.latitude];\n          const offRoute = this.distancePointToRoute(currentPoint) > this.distanceThreshold;\n          if (offRoute == true && this.isOffRoute === false) {\n            this.audio.play();\n          }\n          this.isOffRoute = offRoute;\n        }\n        this.checkGeofences(position.coords.latitude, position.coords.longitude);\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  async setPlannedRoute(options: SetPlannedRouteOptions): Promise<void> {\n    if (!options.soundFile) {\n      throw new Error('Sound file is required');\n    }\n    if (this.audio) {\n      this.audio.pause();\n      this.audio.src = '';\n      this.audio = undefined;\n    }\n    this.audio = new Audio(options.soundFile);\n    this.plannedRoute = options.route || [];\n    this.distanceThreshold = options.distance || 50;\n  }\n\n  async setupGeofencing(options: GeofenceSetupOptions): Promise<void> {\n    if (options.url) {\n      new URL(options.url);\n    }\n    this.geofenceUrl = options.url;\n    this.notifyOnEntry = options.notifyOnEntry ?? true;\n    this.notifyOnExit = options.notifyOnExit ?? true;\n    this.geofencePayload = options.payload ?? {};\n  }\n\n  async addGeofence(options: AddGeofenceOptions): Promise<void> {\n    if (!navigator.geolocation) {\n      throw new Error('Geolocation is not supported by this browser');\n    }\n    this.validateGeofence(options.latitude, options.longitude, options.radius ?? 50, options.identifier);\n    this.geofences.set(options.identifier, {\n      latitude: options.latitude,\n      longitude: options.longitude,\n      radius: options.radius ?? 50,\n      identifier: options.identifier,\n      notifyOnEntry: options.notifyOnEntry ?? this.notifyOnEntry,\n      notifyOnExit: options.notifyOnExit ?? this.notifyOnExit,\n      payload: options.payload,\n    });\n    this.startGeofenceWatch();\n  }\n\n  async removeGeofence(options: RemoveGeofenceOptions): Promise<void> {\n    if (!options.identifier) {\n      throw new Error('Identifier is required');\n    }\n    this.geofences.delete(options.identifier);\n    this.stopGeofenceWatchIfIdle();\n  }\n\n  async removeAllGeofences(): Promise<void> {\n    this.geofences.clear();\n    this.stopGeofenceWatchIfIdle();\n  }\n\n  async getMonitoredGeofences(): Promise<MonitoredGeofencesResult> {\n    return { regions: Array.from(this.geofences.keys()) };\n  }\n\n  private validateGeofence(latitude: number, longitude: number, radius: number, identifier: string): void {\n    if (!identifier) {\n      throw new Error('Identifier is required');\n    }\n    if (!Number.isFinite(latitude) || latitude < -90 || latitude > 90) {\n      throw new Error('Latitude must be between -90 and 90');\n    }\n    if (!Number.isFinite(longitude) || longitude < -180 || longitude > 180) {\n      throw new Error('Longitude must be between -180 and 180');\n    }\n    if (!Number.isFinite(radius) || radius <= 0) {\n      throw new Error('Radius must be greater than 0');\n    }\n  }\n\n  private startGeofenceWatch(): void {\n    if (this.geofenceWatchId !== undefined || this.geofences.size === 0 || !navigator.geolocation) {\n      return;\n    }\n    this.geofenceWatchId = navigator.geolocation.watchPosition(\n      (position) => this.checkGeofences(position.coords.latitude, position.coords.longitude),\n      () => undefined,\n      {\n        enableHighAccuracy: false,\n        timeout: 30000,\n        maximumAge: 60000,\n      },\n    );\n  }\n\n  private stopGeofenceWatchIfIdle(): void {\n    if (this.geofences.size > 0 || this.geofenceWatchId === undefined) {\n      return;\n    }\n    navigator.geolocation.clearWatch(this.geofenceWatchId);\n    this.geofenceWatchId = undefined;\n  }\n\n  private checkGeofences(latitude: number, longitude: number): void {\n    const point: [number, number] = [longitude, latitude];\n    this.geofences.forEach((geofence) => {\n      const distance = this.haversine(point, [geofence.longitude, geofence.latitude]);\n      const inside = distance <= geofence.radius;\n      const previousInside = geofence.inside;\n      geofence.inside = inside;\n\n      if (inside && previousInside !== true && geofence.notifyOnEntry) {\n        this.emitGeofenceTransition(geofence, true);\n      } else if (!inside && previousInside === true && geofence.notifyOnExit) {\n        this.emitGeofenceTransition(geofence, false);\n      }\n    });\n  }\n\n  private emitGeofenceTransition(geofence: WebGeofence, enter: boolean): void {\n    const payload = {\n      ...this.geofencePayload,\n      ...(geofence.payload ?? {}),\n    };\n    const event: GeofenceTransitionEvent = {\n      ...payload,\n      identifier: geofence.identifier,\n      transition: enter ? 'enter' : 'exit',\n      enter,\n      latitude: geofence.latitude,\n      longitude: geofence.longitude,\n      radius: geofence.radius,\n      payload,\n    };\n    void this.notifyListeners('geofenceTransition', event);\n    if (this.geofenceUrl) {\n      void fetch(this.geofenceUrl, {\n        method: 'POST',\n        headers: {\n          Accept: 'application/json',\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify(event),\n      }).catch(() => undefined);\n    }\n  }\n\n  private toRadians(degrees: number): number {\n    return (degrees * Math.PI) / 180;\n  }\n\n  private haversine(point1: [number, number], point2: [number, number]): number {\n    const [lon1, lat1] = point1;\n    const [lon2, lat2] = point2;\n    const dLat = this.toRadians(lat2 - lat1);\n    const dLon = this.toRadians(lon2 - lon1);\n\n    const a =\n      Math.sin(dLat / 2) * Math.sin(dLat / 2) +\n      Math.cos(this.toRadians(lat1)) * Math.cos(this.toRadians(lat2)) * Math.sin(dLon / 2) * Math.sin(dLon / 2);\n\n    const c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));\n\n    return BackgroundGeolocationWeb.EARTH_RADIUS_M * c;\n  }\n\n  private distancePointToLineSegment(\n    point: [number, number],\n    lineStart: [number, number],\n    lineEnd: [number, number],\n  ): number {\n    // Calculate the distances between the three points using Haversine\n    const dist_A_B = this.haversine(point, lineStart);\n    const dist_A_C = this.haversine(point, lineEnd);\n    const dist_B_C = this.haversine(lineStart, lineEnd);\n\n    // Handle the edge case where the line segment is a single point\n    if (dist_B_C === 0) {\n      return dist_A_B;\n    }\n\n    // Check if the angles at the line segment's endpoints are obtuse.\n    // We use the Law of Cosines (c^2 = a^2 + b^2 - 2ab*cos(C))\n    // If cos(C) < 0, the angle is obtuse.\n\n    // Angle at B (lineStart)\n    // Use a small epsilon to handle floating point inaccuracies in division by zero\n    const cos_B = (dist_A_B ** 2 + dist_B_C ** 2 - dist_A_C ** 2) / (2 * dist_A_B * dist_B_C + Number.EPSILON);\n    if (cos_B < 0) {\n      return dist_A_B;\n    }\n\n    // Angle at C (lineEnd)\n    const cos_C = (dist_A_C ** 2 + dist_B_C ** 2 - dist_A_B ** 2) / (2 * dist_A_C * dist_B_C + Number.EPSILON);\n    if (cos_C < 0) {\n      return dist_A_C;\n    }\n\n    // If both angles are acute, the closest point is on the line segment itself.\n    // We can calculate the distance (height of the triangle) using its area.\n\n    // 1. Calculate the semi-perimeter of the triangle ABC\n    const s = (dist_A_B + dist_A_C + dist_B_C) / 2;\n\n    // 2. Calculate the area using Heron's formula\n    const area = Math.sqrt(Math.max(0, s * (s - dist_A_B) * (s - dist_A_C) * (s - dist_B_C)));\n\n    // 3. The distance is the height of the triangle from point A to the base BC\n    // Area = 0.5 * base * height  =>  height = 2 * Area / base\n    return (2 * area) / (dist_B_C + Number.EPSILON);\n  }\n\n  private distancePointToRoute(point: [number, number]): number {\n    // If the route has less than 2 points, we can't form a segment.\n    if (this.plannedRoute.length < 2) {\n      if (this.plannedRoute.length === 1) {\n        return this.haversine(point, this.plannedRoute[0]);\n      }\n      return Infinity; // No line segments to measure against\n    }\n\n    let minDistance = Infinity;\n\n    for (let i = 0; i < this.plannedRoute.length - 1; i++) {\n      const lineStart = this.plannedRoute[i];\n      const lineEnd = this.plannedRoute[i + 1];\n      const distance = this.distancePointToLineSegment(point, lineStart, lineEnd);\n      if (distance < minDistance) {\n        minDistance = distance;\n      }\n    }\n\n    return minDistance;\n  }\n\n  async getPluginVersion(): Promise<{ version: string }> {\n    return { version: 'web' };\n  }\n}\n"]}