react-native-nitro-location-tracking 0.1.8 → 0.1.10

package/README.md

@@ -91,7 +91,8 @@ const granted = await requestLocationPermission(
   },
   {
     title: 'Background Location',
-    message: 'Allow background location to keep tracking while the app is minimized.',
+    message:
+      'Allow background location to keep tracking while the app is minimized.',
     buttonPositive: 'Allow',
     buttonNegative: 'Deny',
   }
@@ -109,13 +110,13 @@ import { useDriverLocation } from 'react-native-nitro-location-tracking';
 import type { LocationConfig } from 'react-native-nitro-location-tracking';
 
 const config: LocationConfig = {
-  desiredAccuracy: 'high',           // 'high' | 'balanced' | 'low'
-  distanceFilter: 10,                // meters
-  intervalMs: 3000,                  // Android only
-  fastestIntervalMs: 1000,           // Android only
-  stopTimeout: 5,                    // minutes before declaring stopped
-  stopOnTerminate: false,            // keep tracking after app close (Android)
-  startOnBoot: true,                 // restart tracking after reboot (Android)
+  desiredAccuracy: 'high', // 'high' | 'balanced' | 'low'
+  distanceFilter: 10, // meters
+  intervalMs: 3000, // Android only
+  fastestIntervalMs: 1000, // Android only
+  stopTimeout: 5, // minutes before declaring stopped
+  stopOnTerminate: false, // keep tracking after app close (Android)
+  startOnBoot: true, // restart tracking after reboot (Android)
   foregroundNotificationTitle: 'Tracking Active',
   foregroundNotificationText: 'Your location is being tracked',
 };
@@ -155,8 +156,8 @@ const connectionConfig: ConnectionConfig = {
   authToken: 'your-auth-token',
   reconnectIntervalMs: 5000,
   maxReconnectAttempts: 10,
-  batchSize: 5,           // locations per batch upload
-  syncIntervalMs: 10000,  // flush queue every 10s
+  batchSize: 5, // locations per batch upload
+  syncIntervalMs: 10000, // flush queue every 10s
 };
 
 function RideScreen() {
@@ -238,10 +239,10 @@ NitroLocationModule.onLocation((location) => {
 
 **Platform behavior:**
 
-| Platform | Per-location detection | Device-level detection |
-|----------|----------------------|------------------------|
-| Android | `Location.isMock` (API 31+) / `isFromMockProvider` (API 18+) | `AppOpsManager` mock location check |
-| iOS | `CLLocation.sourceInformation.isSimulatedBySoftware` (iOS 15+) | Simulator detection |
+| Platform | Per-location detection                                         | Device-level detection              |
+| -------- | -------------------------------------------------------------- | ----------------------------------- |
+| Android  | `Location.isMock` (API 31+) / `isFromMockProvider` (API 18+)   | `AppOpsManager` mock location check |
+| iOS      | `CLLocation.sourceInformation.isSimulatedBySoftware` (iOS 15+) | Simulator detection                 |
 
 ### Smooth Map Marker Animation
 
@@ -287,7 +288,10 @@ function MapScreen() {
 Calculate bearing between two coordinates and handle rotation smoothing:
 
 ```tsx
-import { calculateBearing, shortestRotation } from 'react-native-nitro-location-tracking';
+import {
+  calculateBearing,
+  shortestRotation,
+} from 'react-native-nitro-location-tracking';
 
 // Calculate bearing from point A to point B (in degrees, 0-360)
 const bearing = calculateBearing(
@@ -333,6 +337,49 @@ NitroLocationModule.removeAllGeofences();
 
 > **Note:** iOS limits geofence regions to 20 per app. Android supports up to 100.
 
+### Distance Utilities
+
+Calculate distance between two points or from the current location to a registered geofence:
+
+```tsx
+import NitroLocationModule from 'react-native-nitro-location-tracking';
+
+// Calculate distance between any two coordinates (returns meters)
+const meters = NitroLocationModule.getDistanceBetween(
+  41.311158,
+  69.279737, // point A
+  41.3152,
+  69.2851 // point B
+);
+console.log(`Distance: ${meters.toFixed(0)}m`);
+
+// Get distance from current location to a registered geofence center
+// First, register a geofence
+NitroLocationModule.addGeofence({
+  id: 'branch-123',
+  latitude: 41.311158,
+  longitude: 69.279737,
+  radius: 150,
+  notifyOnEntry: true,
+  notifyOnExit: true,
+});
+
+// Then query distance using the same region id
+const distToBranch = NitroLocationModule.getDistanceToGeofence('branch-123');
+if (distToBranch >= 0) {
+  console.log(`Distance to branch: ${distToBranch.toFixed(0)}m`);
+} else {
+  console.warn('Geofence not found or no location available');
+}
+```
+
+**Key points:**
+
+- Both methods use **native distance APIs** (`CLLocation.distance(from:)` on iOS, `Location.distanceBetween()` on Android) — no JS-thread computation.
+- `getDistanceBetween()` is a pure utility — pass any two lat/lng pairs.
+- `getDistanceToGeofence()` uses the device's **last known native location** and the registered geofence center. Returns `-1` if the region ID is not found or no location is available.
+- The `regionId` is the `id` string you set when calling `addGeofence()`.
+
 ### Speed Monitoring
 
 Get alerts when speed crosses configurable thresholds:
@@ -342,9 +389,9 @@ import NitroLocationModule from 'react-native-nitro-location-tracking';
 
 // Configure speed thresholds
 NitroLocationModule.configureSpeedMonitor({
-  maxSpeedKmh: 120,    // alert when exceeding 120 km/h
-  minSpeedKmh: 5,      // alert when below 5 km/h (idle detection)
-  checkIntervalMs: 0,  // check on every location update
+  maxSpeedKmh: 120, // alert when exceeding 120 km/h
+  minSpeedKmh: 5, // alert when below 5 km/h (idle detection)
+  checkIntervalMs: 0, // check on every location update
 });
 
 // Listen for speed state transitions
@@ -434,13 +481,91 @@ switch (status) {
 }
 ```
 
-| Status | iOS | Android |
-|--------|-----|----------|
-| `notDetermined` | Not yet asked | N/A (returns `denied`) |
-| `denied` | User denied | Fine location not granted |
-| `restricted` | Parental/MDM restriction | N/A (returns `denied`) |
-| `whenInUse` | Authorized when in use | Fine granted, background not |
-| `always` | Authorized always | Fine + background granted |
+| Status          | iOS                      | Android                      |
+| --------------- | ------------------------ | ---------------------------- |
+| `notDetermined` | Not yet asked            | N/A (returns `denied`)       |
+| `denied`        | User denied              | Fine location not granted    |
+| `restricted`    | Parental/MDM restriction | N/A (returns `denied`)       |
+| `whenInUse`     | Authorized when in use   | Fine granted, background not |
+| `always`        | Authorized always        | Fine + background granted    |
+
+### Request Permission (Native)
+
+Request location permission directly via the native module and get the resulting status:
+
+```tsx
+import NitroLocationModule from 'react-native-nitro-location-tracking';
+
+async function setup() {
+  // Check current status first (no dialog)
+  const current = NitroLocationModule.getLocationPermissionStatus();
+
+  if (current === 'always' || current === 'whenInUse') {
+    // Already granted — start tracking
+    NitroLocationModule.startTracking();
+    return;
+  }
+
+  // Request permission — shows the system dialog
+  const status = await NitroLocationModule.requestLocationPermission();
+
+  switch (status) {
+    case 'always':
+    case 'whenInUse':
+      NitroLocationModule.startTracking();
+      break;
+    case 'denied':
+      Alert.alert('Location Required', 'Please enable location in Settings');
+      break;
+    case 'restricted':
+      // Parental controls / MDM — cannot request
+      break;
+  }
+}
+```
+
+**Platform behavior:**
+
+| Platform | Behavior                                                                                                                                                                                                               |
+| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| iOS      | Calls `requestAlwaysAuthorization()`. If permission is already determined, resolves immediately with current status. If `start()` was called before permission was granted, tracking auto-starts once the user allows. |
+| Android  | Uses React Native's `PermissionAwareActivity` to show the system permission dialog for `ACCESS_FINE_LOCATION` + `ACCESS_COARSE_LOCATION`. Resolves with the resulting status after the user responds.                  |
+
+### Permission Change Listener
+
+Listen for permission changes in real time. The callback fires whenever the user changes the location permission (via the system dialog, the Settings app, or MDM policy changes):
+
+```tsx
+import NitroLocationModule from 'react-native-nitro-location-tracking';
+
+// Register a listener — fires whenever the permission status changes
+NitroLocationModule.onPermissionStatusChange((status) => {
+  console.log('Permission changed to:', status);
+  // status: 'notDetermined' | 'denied' | 'restricted' | 'whenInUse' | 'always'
+
+  switch (status) {
+    case 'always':
+      console.log('Background location granted — full tracking available');
+      break;
+    case 'whenInUse':
+      console.log('Foreground only — background tracking may not work');
+      break;
+    case 'denied':
+      Alert.alert('Location Required', 'Please re-enable location in Settings');
+      break;
+    case 'restricted':
+      console.warn('Location restricted by parental controls or MDM');
+      break;
+  }
+});
+```
+
+**Platform behavior:**
+
+| Platform | Mechanism | When the callback fires |
+| -------- | --------- | ----------------------- |
+| iOS      | `locationManagerDidChangeAuthorization` delegate | Immediately when the user changes permission (system dialog, Settings, MDM) |
+| Android  | `ProcessLifecycleOwner` lifecycle observer | When the app returns to foreground after the user changes permission in Settings |
 
 ## API Reference
 
@@ -453,11 +578,11 @@ interface LocationData {
   latitude: number;
   longitude: number;
   altitude: number;
-  speed: number;             // m/s
-  bearing: number;           // degrees
-  accuracy: number;          // meters
-  timestamp: number;         // unix ms
-  isMockLocation?: boolean;  // true when from a mock provider
+  speed: number; // m/s
+  bearing: number; // degrees
+  accuracy: number; // meters
+  timestamp: number; // unix ms
+  isMockLocation?: boolean; // true when from a mock provider
 }
 ```
 
@@ -466,12 +591,12 @@ interface LocationData {
 ```ts
 interface LocationConfig {
   desiredAccuracy: 'high' | 'balanced' | 'low';
-  distanceFilter: number;                  // meters
-  intervalMs: number;                      // Android only
-  fastestIntervalMs: number;               // Android only
-  stopTimeout: number;                     // minutes before declaring stopped
-  stopOnTerminate: boolean;                // keep tracking after app close (Android)
-  startOnBoot: boolean;                    // restart tracking after reboot (Android)
+  distanceFilter: number; // meters
+  intervalMs: number; // Android only
+  fastestIntervalMs: number; // Android only
+  stopTimeout: number; // minutes before declaring stopped
+  stopOnTerminate: boolean; // keep tracking after app close (Android)
+  startOnBoot: boolean; // restart tracking after reboot (Android)
   foregroundNotificationTitle: string;
   foregroundNotificationText: string;
 }
@@ -486,7 +611,7 @@ interface ConnectionConfig {
   authToken: string;
   reconnectIntervalMs: number;
   maxReconnectAttempts: number;
-  batchSize: number;      // locations per batch upload
+  batchSize: number; // locations per batch upload
   syncIntervalMs: number; // how often to flush queue
 }
 ```
@@ -498,7 +623,7 @@ interface GeofenceRegion {
   id: string;
   latitude: number;
   longitude: number;
-  radius: number;          // meters
+  radius: number; // meters
   notifyOnEntry: boolean;
   notifyOnExit: boolean;
 }
@@ -508,9 +633,9 @@ interface GeofenceRegion {
 
 ```ts
 interface SpeedConfig {
-  maxSpeedKmh: number;       // speed limit in km/h
-  minSpeedKmh: number;       // minimum speed threshold
-  checkIntervalMs: number;   // how often to evaluate
+  maxSpeedKmh: number; // speed limit in km/h
+  minSpeedKmh: number; // minimum speed threshold
+  checkIntervalMs: number; // how often to evaluate
 }
 ```
 
@@ -539,58 +664,62 @@ type PermissionStatus =
 
 ### Hooks
 
-| Hook | Returns | Description |
-|------|---------|-------------|
-| `useDriverLocation(config)` | `{ location, isMoving, isTracking, startTracking, stopTracking }` | Manages location tracking lifecycle |
-| `useRideConnection(config)` | `{ connectionState, lastMessage, connect, disconnect, send }` | Manages WebSocket connection lifecycle |
+| Hook                        | Returns                                                           | Description                            |
+| --------------------------- | ----------------------------------------------------------------- | -------------------------------------- |
+| `useDriverLocation(config)` | `{ location, isMoving, isTracking, startTracking, stopTracking }` | Manages location tracking lifecycle    |
+| `useRideConnection(config)` | `{ connectionState, lastMessage, connect, disconnect, send }`     | Manages WebSocket connection lifecycle |
 
 ### Native Module Methods
 
-| Method | Returns | Description |
-|--------|---------|-------------|
-| `configure(config)` | `void` | Set location tracking configuration |
-| `startTracking()` | `void` | Start location tracking |
-| `stopTracking()` | `void` | Stop location tracking |
-| `getCurrentLocation()` | `Promise<LocationData>` | Get a one-shot location |
-| `isTracking()` | `boolean` | Check if tracking is active |
-| `onLocation(callback)` | `void` | Register location update callback |
-| `onMotionChange(callback)` | `void` | Register motion state callback |
-| `configureConnection(config)` | `void` | Set WebSocket/REST configuration |
-| `connectWebSocket()` | `void` | Open WebSocket connection |
-| `disconnectWebSocket()` | `void` | Close WebSocket connection |
-| `sendMessage(message)` | `void` | Send a message via WebSocket |
-| `getConnectionState()` | `ConnectionState` | Get current connection state |
-| `onConnectionStateChange(callback)` | `void` | Register connection state callback |
-| `onMessage(callback)` | `void` | Register incoming message callback |
-| `forceSync()` | `Promise<boolean>` | Flush queued locations to server |
-| `isFakeGpsEnabled()` | `boolean` | Check if device-level mock location is enabled |
-| `setRejectMockLocations(reject)` | `void` | Auto-reject mock locations when `true` |
-| `addGeofence(region)` | `void` | Start monitoring a circular geofence region |
-| `removeGeofence(regionId)` | `void` | Stop monitoring a specific geofence |
-| `removeAllGeofences()` | `void` | Remove all active geofences |
-| `onGeofenceEvent(callback)` | `void` | Register geofence enter/exit callback |
-| `configureSpeedMonitor(config)` | `void` | Set speed monitoring thresholds |
-| `onSpeedAlert(callback)` | `void` | Register speed state-transition callback |
-| `getCurrentSpeed()` | `number` | Get current speed in km/h |
-| `startTripCalculation()` | `void` | Start recording trip distance/stats |
-| `stopTripCalculation()` | `TripStats` | Stop recording and get final stats |
-| `getTripStats()` | `TripStats` | Get current trip stats without stopping |
-| `resetTripCalculation()` | `void` | Reset trip calculator |
-| `isLocationServicesEnabled()` | `boolean` | Check if GPS/location is enabled on device |
-| `onProviderStatusChange(callback)` | `void` | Register GPS/network provider status callback |
-| `getLocationPermissionStatus()` | `PermissionStatus` | Check current location permission without prompting |
-| `showLocalNotification(title, body)` | `void` | Show a local notification |
-| `updateForegroundNotification(title, body)` | `void` | Update the foreground service notification |
-| `destroy()` | `void` | Stop tracking and disconnect |
+| Method                                       | Returns                     | Description                                                                              |
+| -------------------------------------------- | --------------------------- | ---------------------------------------------------------------------------------------- |
+| `configure(config)`                          | `void`                      | Set location tracking configuration                                                      |
+| `startTracking()`                            | `void`                      | Start location tracking                                                                  |
+| `stopTracking()`                             | `void`                      | Stop location tracking                                                                   |
+| `getCurrentLocation()`                       | `Promise<LocationData>`     | Get a one-shot location                                                                  |
+| `isTracking()`                               | `boolean`                   | Check if tracking is active                                                              |
+| `onLocation(callback)`                       | `void`                      | Register location update callback                                                        |
+| `onMotionChange(callback)`                   | `void`                      | Register motion state callback                                                           |
+| `configureConnection(config)`                | `void`                      | Set WebSocket/REST configuration                                                         |
+| `connectWebSocket()`                         | `void`                      | Open WebSocket connection                                                                |
+| `disconnectWebSocket()`                      | `void`                      | Close WebSocket connection                                                               |
+| `sendMessage(message)`                       | `void`                      | Send a message via WebSocket                                                             |
+| `getConnectionState()`                       | `ConnectionState`           | Get current connection state                                                             |
+| `onConnectionStateChange(callback)`          | `void`                      | Register connection state callback                                                       |
+| `onMessage(callback)`                        | `void`                      | Register incoming message callback                                                       |
+| `forceSync()`                                | `Promise<boolean>`          | Flush queued locations to server                                                         |
+| `isFakeGpsEnabled()`                         | `boolean`                   | Check if device-level mock location is enabled                                           |
+| `setRejectMockLocations(reject)`             | `void`                      | Auto-reject mock locations when `true`                                                   |
+| `addGeofence(region)`                        | `void`                      | Start monitoring a circular geofence region                                              |
+| `removeGeofence(regionId)`                   | `void`                      | Stop monitoring a specific geofence                                                      |
+| `removeAllGeofences()`                       | `void`                      | Remove all active geofences                                                              |
+| `onGeofenceEvent(callback)`                  | `void`                      | Register geofence enter/exit callback                                                    |
+| `getDistanceBetween(lat1, lon1, lat2, lon2)` | `number`                    | Calculate distance between two points in meters (native Haversine)                       |
+| `getDistanceToGeofence(regionId)`            | `number`                    | Get distance in meters from last known location to a geofence center (`-1` if not found) |
+| `configureSpeedMonitor(config)`              | `void`                      | Set speed monitoring thresholds                                                          |
+| `onSpeedAlert(callback)`                     | `void`                      | Register speed state-transition callback                                                 |
+| `getCurrentSpeed()`                          | `number`                    | Get current speed in km/h                                                                |
+| `startTripCalculation()`                     | `void`                      | Start recording trip distance/stats                                                      |
+| `stopTripCalculation()`                      | `TripStats`                 | Stop recording and get final stats                                                       |
+| `getTripStats()`                             | `TripStats`                 | Get current trip stats without stopping                                                  |
+| `resetTripCalculation()`                     | `void`                      | Reset trip calculator                                                                    |
+| `isLocationServicesEnabled()`                | `boolean`                   | Check if GPS/location is enabled on device                                               |
+| `onProviderStatusChange(callback)`           | `void`                      | Register GPS/network provider status callback                                            |
+| `getLocationPermissionStatus()`              | `PermissionStatus`          | Check current location permission without prompting                                      |
+| `requestLocationPermission()`                | `Promise<PermissionStatus>` | Request location permission and return the resulting status                              |
+| `onPermissionStatusChange(callback)`         | `void`                      | Register a callback that fires when location permission status changes                   |
+| `showLocalNotification(title, body)`         | `void`                      | Show a local notification                                                                |
+| `updateForegroundNotification(title, body)`  | `void`                      | Update the foreground service notification                                               |
+| `destroy()`                                  | `void`                      | Stop tracking and disconnect                                                             |
 
 ### Utility Exports
 
-| Export | Description |
-|--------|-------------|
-| `LocationSmoother` | Class for smooth map marker animation between updates |
-| `calculateBearing(from, to)` | Calculate bearing between two coordinates (degrees, 0-360) |
-| `shortestRotation(from, to)` | Calculate shortest rotation path to avoid spinning |
-| `requestLocationPermission()` | Request location + notification permissions (Android) |
+| Export                        | Description                                                |
+| ----------------------------- | ---------------------------------------------------------- |
+| `LocationSmoother`            | Class for smooth map marker animation between updates      |
+| `calculateBearing(from, to)`  | Calculate bearing between two coordinates (degrees, 0-360) |
+| `shortestRotation(from, to)`  | Calculate shortest rotation path to avoid spinning         |
+| `requestLocationPermission()` | Request location + notification permissions (Android)      |
 
 ## Publishing to npm
 

package/android/build.gradle

@@ -119,4 +119,5 @@ dependencies {
   implementation "com.squareup.okhttp3:okhttp:4.12.0"
   implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.9.0"
   implementation "androidx.core:core-ktx:1.15.0"
+  implementation "androidx.lifecycle:lifecycle-process:2.8.7"
 }

package/android/src/main/java/com/margelo/nitro/nitrolocationtracking/GeofenceManager.kt

@@ -135,6 +135,16 @@ class GeofenceManager(private val context: Context) {
         }
     }
 
+    fun distanceTo(regionId: String, lastLocation: android.location.Location?): Double {
+        val region = activeRegions[regionId] ?: return -1.0
+        val loc = lastLocation ?: return -1.0
+        val results = FloatArray(1)
+        android.location.Location.distanceBetween(
+            loc.latitude, loc.longitude, region.latitude, region.longitude, results
+        )
+        return results[0].toDouble()
+    }
+
     fun destroy() {
         removeAllGeofences()
         receiver?.let {

package/android/src/main/java/com/margelo/nitro/nitrolocationtracking/LocationEngine.kt

@@ -28,6 +28,8 @@ class LocationEngine(private val context: Context) {
   val tripCalculator = TripCalculator()
   private var lastSpeed = 0f
   private var tracking = false
+  var lastLocation: Location? = null
+    private set
 
   val isTracking: Boolean get() = tracking
 
@@ -90,6 +92,7 @@ class LocationEngine(private val context: Context) {
 //  }
 
   private fun processLocation(location: Location) {
+    lastLocation = location
     val data = locationToData(location)
 
     // Skip mock locations if rejection is enabled

package/android/src/main/java/com/margelo/nitro/nitrolocationtracking/NitroLocationTracking.kt

@@ -26,6 +26,7 @@ class NitroLocationTracking : HybridNitroLocationTrackingSpec() {
     private var notificationService: NotificationService? = null
     private var geofenceManager: GeofenceManager? = null
     private var providerStatusMonitor: ProviderStatusMonitor? = null
+    private var permissionStatusMonitor: PermissionStatusMonitor? = null
 
     private var locationCallback: ((LocationData) -> Unit)? = null
     private var motionCallback: ((Boolean) -> Unit)? = null
@@ -34,6 +35,7 @@ class NitroLocationTracking : HybridNitroLocationTrackingSpec() {
     private var geofenceCallback: ((GeofenceEvent, String) -> Unit)? = null
     private var speedAlertCallback: ((SpeedAlertType, Double) -> Unit)? = null
     private var providerStatusCallback: ((LocationProviderStatus, LocationProviderStatus) -> Unit)? = null
+    private var permissionStatusCallback: ((PermissionStatus) -> Unit)? = null
 
     private var locationConfig: LocationConfig? = null
 
@@ -50,6 +52,7 @@ class NitroLocationTracking : HybridNitroLocationTrackingSpec() {
         notificationService = NotificationService(context)
         geofenceManager = GeofenceManager(context)
         providerStatusMonitor = ProviderStatusMonitor(context)
+        permissionStatusMonitor = PermissionStatusMonitor(context)
         locationEngine?.dbWriter = dbWriter
         connectionManager.dbWriter = dbWriter
         Log.d(TAG, "Components initialized successfully")
@@ -286,6 +289,12 @@ class NitroLocationTracking : HybridNitroLocationTrackingSpec() {
         return PermissionStatus.ALWAYS
     }
 
+    override fun onPermissionStatusChange(callback: (status: PermissionStatus) -> Unit) {
+        permissionStatusCallback = callback
+        ensureInitialized()
+        permissionStatusMonitor?.setCallback(callback)
+    }
+
     override fun requestLocationPermission(): Promise<PermissionStatus> {
         return Promise.async {
             suspendCoroutine { cont ->
@@ -346,6 +355,19 @@ class NitroLocationTracking : HybridNitroLocationTrackingSpec() {
         }
     }
 
+    // === Distance Utilities ===
+
+    override fun getDistanceBetween(lat1: Double, lon1: Double, lat2: Double, lon2: Double): Double {
+        val results = FloatArray(1)
+        android.location.Location.distanceBetween(lat1, lon1, lat2, lon2, results)
+        return results[0].toDouble()
+    }
+
+    override fun getDistanceToGeofence(regionId: String): Double {
+        ensureInitialized()
+        return geofenceManager?.distanceTo(regionId, locationEngine?.lastLocation) ?: -1.0
+    }
+
     // === Notifications ===
 
     override fun showLocalNotification(title: String, body: String) {
@@ -366,5 +388,6 @@ class NitroLocationTracking : HybridNitroLocationTrackingSpec() {
         notificationService?.stopForegroundService()
         geofenceManager?.destroy()
         providerStatusMonitor?.destroy()
+        permissionStatusMonitor?.destroy()
     }
 }

package/android/src/main/java/com/margelo/nitro/nitrolocationtracking/PermissionStatusMonitor.kt

@@ -0,0 +1,85 @@
+package com.margelo.nitro.nitrolocationtracking
+
+import android.content.Context
+import android.content.pm.PackageManager
+import android.os.Build
+import android.util.Log
+import androidx.core.content.ContextCompat
+import androidx.lifecycle.DefaultLifecycleObserver
+import androidx.lifecycle.LifecycleOwner
+import androidx.lifecycle.ProcessLifecycleOwner
+
+/**
+ * Monitors location‐permission changes by comparing the permission status
+ * every time the app comes to the foreground (`ON_START`).
+ *
+ * Android has no broadcast for permission changes, so consuming the
+ * lifecycle is the standard approach (same as react-native-permissions).
+ */
+class PermissionStatusMonitor(private val context: Context) {
+
+    companion object {
+        private const val TAG = "PermissionStatusMonitor"
+    }
+
+    private var callback: ((PermissionStatus) -> Unit)? = null
+    private var lastStatus: PermissionStatus? = null
+
+    private val lifecycleObserver = object : DefaultLifecycleObserver {
+        override fun onStart(owner: LifecycleOwner) {
+            checkAndNotify()
+        }
+    }
+
+    fun setCallback(callback: (PermissionStatus) -> Unit) {
+        this.callback = callback
+        // Capture the current status so we only fire on actual changes
+        lastStatus = getCurrentPermissionStatus()
+
+        // Observe the process lifecycle (app foreground / background)
+        try {
+            ProcessLifecycleOwner.get().lifecycle.addObserver(lifecycleObserver)
+            Log.d(TAG, "Registered lifecycle observer for permission changes")
+        } catch (e: Exception) {
+            Log.e(TAG, "Failed to register lifecycle observer: ${e.message}")
+        }
+    }
+
+    private fun checkAndNotify() {
+        val current = getCurrentPermissionStatus()
+        if (current != lastStatus) {
+            Log.d(TAG, "Permission status changed: $lastStatus -> $current")
+            lastStatus = current
+            callback?.invoke(current)
+        }
+    }
+
+    private fun getCurrentPermissionStatus(): PermissionStatus {
+        val fineGranted = ContextCompat.checkSelfPermission(
+            context, android.Manifest.permission.ACCESS_FINE_LOCATION
+        ) == PackageManager.PERMISSION_GRANTED
+
+        if (!fineGranted) {
+            return PermissionStatus.DENIED
+        }
+
+        // Fine location granted — check background
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
+            val bgGranted = ContextCompat.checkSelfPermission(
+                context, android.Manifest.permission.ACCESS_BACKGROUND_LOCATION
+            ) == PackageManager.PERMISSION_GRANTED
+            return if (bgGranted) PermissionStatus.ALWAYS else PermissionStatus.WHENINUSE
+        }
+
+        // Pre-Android 10: fine location = always
+        return PermissionStatus.ALWAYS
+    }
+
+    fun destroy() {
+        try {
+            ProcessLifecycleOwner.get().lifecycle.removeObserver(lifecycleObserver)
+        } catch (_: Exception) {}
+        callback = null
+        lastStatus = null
+    }
+}

package/ios/GeofenceManager.swift

@@ -62,6 +62,12 @@ class GeofenceManager: NSObject, CLLocationManagerDelegate {
         }
     }
 
+    func distanceTo(regionId: String, from location: CLLocation?) -> Double {
+        guard let region = activeRegions[regionId], let location = location else { return -1 }
+        let center = CLLocation(latitude: region.latitude, longitude: region.longitude)
+        return location.distance(from: center)
+    }
+
     func destroy() {
         removeAllGeofences()
         callback = nil

package/ios/LocationEngine.swift

@@ -22,6 +22,12 @@ class LocationEngine: NSObject, CLLocationManagerDelegate {
     let speedMonitor = SpeedMonitor()
     let tripCalculator = TripCalculator()
     var providerStatusCallback: ((LocationProviderStatus, LocationProviderStatus) -> Void)?
+    var permissionStatusCallback: ((PermissionStatus) -> Void)?
+
+    /// The most recently received location from Core Location (for distance calculations)
+    var lastCLLocation: CLLocation? {
+        return locationManager.location
+    }
 
     override init() {
         super.init()
@@ -207,6 +213,24 @@ class LocationEngine: NSObject, CLLocationManagerDelegate {
             }
         }
 
+        // Notify JS about permission status change
+        let permStatus: PermissionStatus
+        switch authStatus {
+        case .notDetermined:
+            permStatus = .notdetermined
+        case .restricted:
+            permStatus = .restricted
+        case .denied:
+            permStatus = .denied
+        case .authorizedWhenInUse:
+            permStatus = .wheninuse
+        case .authorizedAlways:
+            permStatus = .always
+        @unknown default:
+            permStatus = .notdetermined
+        }
+        permissionStatusCallback?(permStatus)
+
         let enabled = CLLocationManager.locationServicesEnabled()
         let status: LocationProviderStatus = enabled ? .enabled : .disabled
         providerStatusCallback?(status, status)

package/ios/NitroLocationTracking.swift

@@ -16,6 +16,7 @@ class NitroLocationTracking: HybridNitroLocationTrackingSpec {
     private var geofenceCallback: ((GeofenceEvent, String) -> Void)?
     private var speedAlertCallback: ((SpeedAlertType, Double) -> Void)?
     private var providerStatusCallback: ((LocationProviderStatus, LocationProviderStatus) -> Void)?
+    private var permissionStatusCallback: ((PermissionStatus) -> Void)?
     private var permissionPromise: Promise<PermissionStatus>?
 
     override init() {
@@ -236,6 +237,23 @@ class NitroLocationTracking: HybridNitroLocationTrackingSpec {
         return promise
     }
 
+    func onPermissionStatusChange(callback: @escaping (PermissionStatus) -> Void) throws {
+        permissionStatusCallback = callback
+        locationEngine.permissionStatusCallback = callback
+    }
+
+    // MARK: - Distance Utilities
+
+    func getDistanceBetween(lat1: Double, lon1: Double, lat2: Double, lon2: Double) throws -> Double {
+        let loc1 = CLLocation(latitude: lat1, longitude: lon1)
+        let loc2 = CLLocation(latitude: lat2, longitude: lon2)
+        return loc1.distance(from: loc2)
+    }
+
+    func getDistanceToGeofence(regionId: String) throws -> Double {
+        return geofenceManager.distanceTo(regionId: regionId, from: locationEngine.lastCLLocation)
+    }
+
     // MARK: - Notifications
 
     func showLocalNotification(title: String, body: String) throws {

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["useState","useEffect","useCallback","useRef","NitroModules","NitroLocationModule","createHybridObject","requestLocationPermission","LocationSmoother","shortestRotation","calculateBearing","useDriverLocation","config","location","setLocation","isMoving","setIsMoving","isTracking","setIsTracking","configJson","JSON","stringify","trackingRef","parsed","parse","configure","onLocation","onMotionChange","current","stopTracking","startTracking","useRideConnection","connectionState","setConnectionState","lastMessage","setLastMessage","configureConnection","onConnectionStateChange","onMessage","disconnectWebSocket","connect","connectWebSocket","disconnect","send","m","sendMessage"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["useState","useEffect","useCallback","useRef","NitroModules","NitroLocationModule","createHybridObject","requestLocationPermission","LocationSmoother","shortestRotation","calculateBearing","useDriverLocation","config","location","setLocation","isMoving","setIsMoving","isTracking","setIsTracking","configJson","JSON","stringify","trackingRef","parsed","parse","configure","onLocation","onMotionChange","current","stopTracking","startTracking","useRideConnection","connectionState","setConnectionState","lastMessage","setLastMessage","configureConnection","onConnectionStateChange","onMessage","disconnectWebSocket","connect","connectWebSocket","disconnect","send","m","sendMessage"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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","ignoreList":[]}

package/lib/typescript/src/NitroLocationTracking.nitro.d.ts

@@ -61,6 +61,7 @@ export interface TripStats {
 export type LocationProviderStatus = 'enabled' | 'disabled';
 export type ProviderStatusCallback = (gps: LocationProviderStatus, network: LocationProviderStatus) => void;
 export type PermissionStatus = 'notDetermined' | 'denied' | 'restricted' | 'whenInUse' | 'always';
+export type PermissionStatusCallback = (status: PermissionStatus) => void;
 export interface NitroLocationTracking extends HybridObject<{
     ios: 'swift';
     android: 'kotlin';
@@ -97,6 +98,9 @@ export interface NitroLocationTracking extends HybridObject<{
     onProviderStatusChange(callback: ProviderStatusCallback): void;
     getLocationPermissionStatus(): PermissionStatus;
     requestLocationPermission(): Promise<PermissionStatus>;
+    onPermissionStatusChange(callback: PermissionStatusCallback): void;
+    getDistanceBetween(lat1: number, lon1: number, lat2: number, lon2: number): number;
+    getDistanceToGeofence(regionId: string): number;
     showLocalNotification(title: string, body: string): void;
     updateForegroundNotification(title: string, body: string): void;
     destroy(): void;

package/lib/typescript/src/NitroLocationTracking.nitro.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NitroLocationTracking.nitro.d.ts","sourceRoot":"","sources":["../../../src/NitroLocationTracking.nitro.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"NitroLocationTracking.nitro.d.ts","sourceRoot":"","sources":["../../../src/NitroLocationTracking.nitro.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/index.d.ts

@@ -4,7 +4,7 @@ export default NitroLocationModule;
 export { requestLocationPermission } from './requestPermission';
 export { LocationSmoother } from './LocationSmoother';
 export { shortestRotation, calculateBearing } from './bearing';
-export type { NitroLocationTracking, LocationData, LocationConfig, ConnectionConfig, GeofenceRegion, GeofenceEvent, GeofenceCallback, SpeedConfig, SpeedAlertType, SpeedAlertCallback, TripStats, LocationProviderStatus, ProviderStatusCallback, PermissionStatus, } from './NitroLocationTracking.nitro';
+export type { NitroLocationTracking, LocationData, LocationConfig, ConnectionConfig, GeofenceRegion, GeofenceEvent, GeofenceCallback, SpeedConfig, SpeedAlertType, SpeedAlertCallback, TripStats, LocationProviderStatus, ProviderStatusCallback, PermissionStatus, PermissionStatusCallback, } from './NitroLocationTracking.nitro';
 export declare function useDriverLocation(config: LocationConfig): {
     location: LocationData | null;
     isMoving: boolean;

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACd,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AAEvC,QAAA,MAAM,mBAAmB,uBAGtB,CAAC;AAEJ,eAAe,mBAAmB,CAAC;AACnC,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE/D,YAAY,EACV,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,SAAS,EACT,sBAAsB,EACtB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,+BAA+B,CAAC;AAEvC,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc;;;;;;EAuCvD;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB;;;;;cAuBhC,MAAM;EAE/B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACd,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AAEvC,QAAA,MAAM,mBAAmB,uBAGtB,CAAC;AAEJ,eAAe,mBAAmB,CAAC;AACnC,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE/D,YAAY,EACV,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,SAAS,EACT,sBAAsB,EACtB,sBAAsB,EACtB,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AAEvC,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc;;;;;;EAuCvD;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB;;;;;cAuBhC,MAAM;EAE/B"}

package/nitrogen/generated/android/c++/JFunc_void_PermissionStatus.hpp

@@ -0,0 +1,77 @@
+///
+/// JFunc_void_PermissionStatus.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#include <fbjni/fbjni.h>
+#include <functional>
+
+#include "PermissionStatus.hpp"
+#include <functional>
+#include <NitroModules/JNICallable.hpp>
+#include "JPermissionStatus.hpp"
+
+namespace margelo::nitro::nitrolocationtracking {
+
+  using namespace facebook;
+
+  /**
+   * Represents the Java/Kotlin callback `(status: PermissionStatus) -> Unit`.
+   * This can be passed around between C++ and Java/Kotlin.
+   */
+  struct JFunc_void_PermissionStatus: public jni::JavaClass<JFunc_void_PermissionStatus> {
+  public:
+    static auto constexpr kJavaDescriptor = "Lcom/margelo/nitro/nitrolocationtracking/Func_void_PermissionStatus;";
+
+  public:
+    /**
+     * Invokes the function this `JFunc_void_PermissionStatus` instance holds through JNI.
+     */
+    void invoke(PermissionStatus status) const {
+      static const auto method = javaClassStatic()->getMethod<void(jni::alias_ref<JPermissionStatus> /* status */)>("invoke");
+      method(self(), JPermissionStatus::fromCpp(status));
+    }
+  };
+
+  /**
+   * An implementation of Func_void_PermissionStatus that is backed by a C++ implementation (using `std::function<...>`)
+   */
+  class JFunc_void_PermissionStatus_cxx final: public jni::HybridClass<JFunc_void_PermissionStatus_cxx, JFunc_void_PermissionStatus> {
+  public:
+    static jni::local_ref<JFunc_void_PermissionStatus::javaobject> fromCpp(const std::function<void(PermissionStatus /* status */)>& func) {
+      return JFunc_void_PermissionStatus_cxx::newObjectCxxArgs(func);
+    }
+
+  public:
+    /**
+     * Invokes the C++ `std::function<...>` this `JFunc_void_PermissionStatus_cxx` instance holds.
+     */
+    void invoke_cxx(jni::alias_ref<JPermissionStatus> status) {
+      _func(status->toCpp());
+    }
+
+  public:
+    [[nodiscard]]
+    inline const std::function<void(PermissionStatus /* status */)>& getFunction() const {
+      return _func;
+    }
+
+  public:
+    static auto constexpr kJavaDescriptor = "Lcom/margelo/nitro/nitrolocationtracking/Func_void_PermissionStatus_cxx;";
+    static void registerNatives() {
+      registerHybrid({makeNativeMethod("invoke_cxx", JFunc_void_PermissionStatus_cxx::invoke_cxx)});
+    }
+
+  private:
+    explicit JFunc_void_PermissionStatus_cxx(const std::function<void(PermissionStatus /* status */)>& func): _func(func) { }
+
+  private:
+    friend HybridBase;
+    std::function<void(PermissionStatus /* status */)> _func;
+  };
+
+} // namespace margelo::nitro::nitrolocationtracking

package/nitrogen/generated/android/c++/JHybridNitroLocationTrackingSpec.cpp

@@ -69,6 +69,7 @@ namespace margelo::nitro::nitrolocationtracking { enum class LocationProviderSta
 #include "LocationProviderStatus.hpp"
 #include "JFunc_void_LocationProviderStatus_LocationProviderStatus.hpp"
 #include "JLocationProviderStatus.hpp"
+#include "JFunc_void_PermissionStatus.hpp"
 
 namespace margelo::nitro::nitrolocationtracking {
 
@@ -281,6 +282,20 @@ namespace margelo::nitro::nitrolocationtracking {
       return __promise;
     }();
   }
+  void JHybridNitroLocationTrackingSpec::onPermissionStatusChange(const std::function<void(PermissionStatus /* status */)>& callback) {
+    static const auto method = javaClassStatic()->getMethod<void(jni::alias_ref<JFunc_void_PermissionStatus::javaobject> /* callback */)>("onPermissionStatusChange_cxx");
+    method(_javaPart, JFunc_void_PermissionStatus_cxx::fromCpp(callback));
+  }
+  double JHybridNitroLocationTrackingSpec::getDistanceBetween(double lat1, double lon1, double lat2, double lon2) {
+    static const auto method = javaClassStatic()->getMethod<double(double /* lat1 */, double /* lon1 */, double /* lat2 */, double /* lon2 */)>("getDistanceBetween");
+    auto __result = method(_javaPart, lat1, lon1, lat2, lon2);
+    return __result;
+  }
+  double JHybridNitroLocationTrackingSpec::getDistanceToGeofence(const std::string& regionId) {
+    static const auto method = javaClassStatic()->getMethod<double(jni::alias_ref<jni::JString> /* regionId */)>("getDistanceToGeofence");
+    auto __result = method(_javaPart, jni::make_jstring(regionId));
+    return __result;
+  }
   void JHybridNitroLocationTrackingSpec::showLocalNotification(const std::string& title, const std::string& body) {
     static const auto method = javaClassStatic()->getMethod<void(jni::alias_ref<jni::JString> /* title */, jni::alias_ref<jni::JString> /* body */)>("showLocalNotification");
     method(_javaPart, jni::make_jstring(title), jni::make_jstring(body));

package/nitrogen/generated/android/c++/JHybridNitroLocationTrackingSpec.hpp

@@ -87,6 +87,9 @@ namespace margelo::nitro::nitrolocationtracking {
     void onProviderStatusChange(const std::function<void(LocationProviderStatus /* gps */, LocationProviderStatus /* network */)>& callback) override;
     PermissionStatus getLocationPermissionStatus() override;
     std::shared_ptr<Promise<PermissionStatus>> requestLocationPermission() override;
+    void onPermissionStatusChange(const std::function<void(PermissionStatus /* status */)>& callback) override;
+    double getDistanceBetween(double lat1, double lon1, double lat2, double lon2) override;
+    double getDistanceToGeofence(const std::string& regionId) override;
     void showLocalNotification(const std::string& title, const std::string& body) override;
     void updateForegroundNotification(const std::string& title, const std::string& body) override;
     void destroy() override;

package/nitrogen/generated/android/kotlin/com/margelo/nitro/nitrolocationtracking/Func_void_PermissionStatus.kt

@@ -0,0 +1,80 @@
+///
+/// Func_void_PermissionStatus.kt
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+package com.margelo.nitro.nitrolocationtracking
+
+import androidx.annotation.Keep
+import com.facebook.jni.HybridData
+import com.facebook.proguard.annotations.DoNotStrip
+import dalvik.annotation.optimization.FastNative
+
+
+/**
+ * Represents the JavaScript callback `(status: enum) => void`.
+ * This can be either implemented in C++ (in which case it might be a callback coming from JS),
+ * or in Kotlin/Java (in which case it is a native callback).
+ */
+@DoNotStrip
+@Keep
+@Suppress("ClassName", "RedundantUnitReturnType")
+fun interface Func_void_PermissionStatus: (PermissionStatus) -> Unit {
+  /**
+   * Call the given JS callback.
+   * @throws Throwable if the JS function itself throws an error, or if the JS function/runtime has already been deleted.
+   */
+  @DoNotStrip
+  @Keep
+  override fun invoke(status: PermissionStatus): Unit
+}
+
+/**
+ * Represents the JavaScript callback `(status: enum) => void`.
+ * This is implemented in C++, via a `std::function<...>`.
+ * The callback might be coming from JS.
+ */
+@DoNotStrip
+@Keep
+@Suppress(
+  "KotlinJniMissingFunction", "unused",
+  "RedundantSuppression", "RedundantUnitReturnType", "FunctionName",
+  "ConvertSecondaryConstructorToPrimary", "ClassName", "LocalVariableName",
+)
+class Func_void_PermissionStatus_cxx: Func_void_PermissionStatus {
+  @DoNotStrip
+  @Keep
+  private val mHybridData: HybridData
+
+  @DoNotStrip
+  @Keep
+  private constructor(hybridData: HybridData) {
+    mHybridData = hybridData
+  }
+
+  @DoNotStrip
+  @Keep
+  override fun invoke(status: PermissionStatus): Unit
+    = invoke_cxx(status)
+
+  @FastNative
+  private external fun invoke_cxx(status: PermissionStatus): Unit
+}
+
+/**
+ * Represents the JavaScript callback `(status: enum) => void`.
+ * This is implemented in Java/Kotlin, via a `(PermissionStatus) -> Unit`.
+ * The callback is always coming from native.
+ */
+@DoNotStrip
+@Keep
+@Suppress("ClassName", "RedundantUnitReturnType", "unused")
+class Func_void_PermissionStatus_java(private val function: (PermissionStatus) -> Unit): Func_void_PermissionStatus {
+  @DoNotStrip
+  @Keep
+  override fun invoke(status: PermissionStatus): Unit {
+    return this.function(status)
+  }
+}

package/nitrogen/generated/android/kotlin/com/margelo/nitro/nitrolocationtracking/HybridNitroLocationTrackingSpec.kt

@@ -209,6 +209,23 @@ abstract class HybridNitroLocationTrackingSpec: HybridObject() {
   @Keep
   abstract fun requestLocationPermission(): Promise<PermissionStatus>
   
+  abstract fun onPermissionStatusChange(callback: (status: PermissionStatus) -> Unit): Unit
+  
+  @DoNotStrip
+  @Keep
+  private fun onPermissionStatusChange_cxx(callback: Func_void_PermissionStatus): Unit {
+    val __result = onPermissionStatusChange(callback)
+    return __result
+  }
+  
+  @DoNotStrip
+  @Keep
+  abstract fun getDistanceBetween(lat1: Double, lon1: Double, lat2: Double, lon2: Double): Double
+  
+  @DoNotStrip
+  @Keep
+  abstract fun getDistanceToGeofence(regionId: String): Double
+  
   @DoNotStrip
   @Keep
   abstract fun showLocalNotification(title: String, body: String): Unit

package/nitrogen/generated/android/nitrolocationtrackingOnLoad.cpp

@@ -23,6 +23,7 @@
 #include "JFunc_void_GeofenceEvent_std__string.hpp"
 #include "JFunc_void_SpeedAlertType_double.hpp"
 #include "JFunc_void_LocationProviderStatus_LocationProviderStatus.hpp"
+#include "JFunc_void_PermissionStatus.hpp"
 #include <NitroModules/DefaultConstructableObject.hpp>
 
 namespace margelo::nitro::nitrolocationtracking {
@@ -42,6 +43,7 @@ int initialize(JavaVM* vm) {
     margelo::nitro::nitrolocationtracking::JFunc_void_GeofenceEvent_std__string_cxx::registerNatives();
     margelo::nitro::nitrolocationtracking::JFunc_void_SpeedAlertType_double_cxx::registerNatives();
     margelo::nitro::nitrolocationtracking::JFunc_void_LocationProviderStatus_LocationProviderStatus_cxx::registerNatives();
+    margelo::nitro::nitrolocationtracking::JFunc_void_PermissionStatus_cxx::registerNatives();
 
     // Register Nitro Hybrid Objects
     HybridObjectRegistry::registerHybridObjectConstructor(

package/nitrogen/generated/ios/c++/HybridNitroLocationTrackingSpecSwift.hpp

@@ -318,6 +318,28 @@ namespace margelo::nitro::nitrolocationtracking {
       auto __value = std::move(__result.value());
       return __value;
     }
+    inline void onPermissionStatusChange(const std::function<void(PermissionStatus /* status */)>& callback) override {
+      auto __result = _swiftPart.onPermissionStatusChange(callback);
+      if (__result.hasError()) [[unlikely]] {
+        std::rethrow_exception(__result.error());
+      }
+    }
+    inline double getDistanceBetween(double lat1, double lon1, double lat2, double lon2) override {
+      auto __result = _swiftPart.getDistanceBetween(std::forward<decltype(lat1)>(lat1), std::forward<decltype(lon1)>(lon1), std::forward<decltype(lat2)>(lat2), std::forward<decltype(lon2)>(lon2));
+      if (__result.hasError()) [[unlikely]] {
+        std::rethrow_exception(__result.error());
+      }
+      auto __value = std::move(__result.value());
+      return __value;
+    }
+    inline double getDistanceToGeofence(const std::string& regionId) override {
+      auto __result = _swiftPart.getDistanceToGeofence(regionId);
+      if (__result.hasError()) [[unlikely]] {
+        std::rethrow_exception(__result.error());
+      }
+      auto __value = std::move(__result.value());
+      return __value;
+    }
     inline void showLocalNotification(const std::string& title, const std::string& body) override {
       auto __result = _swiftPart.showLocalNotification(title, body);
       if (__result.hasError()) [[unlikely]] {

package/nitrogen/generated/ios/swift/HybridNitroLocationTrackingSpec.swift

@@ -45,6 +45,9 @@ public protocol HybridNitroLocationTrackingSpec_protocol: HybridObject {
   func onProviderStatusChange(callback: @escaping (_ gps: LocationProviderStatus, _ network: LocationProviderStatus) -> Void) throws -> Void
   func getLocationPermissionStatus() throws -> PermissionStatus
   func requestLocationPermission() throws -> Promise<PermissionStatus>
+  func onPermissionStatusChange(callback: @escaping (_ status: PermissionStatus) -> Void) throws -> Void
+  func getDistanceBetween(lat1: Double, lon1: Double, lat2: Double, lon2: Double) throws -> Double
+  func getDistanceToGeofence(regionId: String) throws -> Double
   func showLocalNotification(title: String, body: String) throws -> Void
   func updateForegroundNotification(title: String, body: String) throws -> Void
   func destroy() throws -> Void

package/nitrogen/generated/ios/swift/HybridNitroLocationTrackingSpec_cxx.swift

@@ -543,6 +543,46 @@ open class HybridNitroLocationTrackingSpec_cxx {
     }
   }
   
+  @inline(__always)
+  public final func onPermissionStatusChange(callback: bridge.Func_void_PermissionStatus) -> bridge.Result_void_ {
+    do {
+      try self.__implementation.onPermissionStatusChange(callback: { () -> (PermissionStatus) -> Void in
+        let __wrappedFunction = bridge.wrap_Func_void_PermissionStatus(callback)
+        return { (__status: PermissionStatus) -> Void in
+          __wrappedFunction.call(__status.rawValue)
+        }
+      }())
+      return bridge.create_Result_void_()
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_void_(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func getDistanceBetween(lat1: Double, lon1: Double, lat2: Double, lon2: Double) -> bridge.Result_double_ {
+    do {
+      let __result = try self.__implementation.getDistanceBetween(lat1: lat1, lon1: lon1, lat2: lat2, lon2: lon2)
+      let __resultCpp = __result
+      return bridge.create_Result_double_(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_double_(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func getDistanceToGeofence(regionId: std.string) -> bridge.Result_double_ {
+    do {
+      let __result = try self.__implementation.getDistanceToGeofence(regionId: String(regionId))
+      let __resultCpp = __result
+      return bridge.create_Result_double_(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_double_(__exceptionPtr)
+    }
+  }
+  
   @inline(__always)
   public final func showLocalNotification(title: std.string, body: std.string) -> bridge.Result_void_ {
     do {

package/nitrogen/generated/shared/c++/HybridNitroLocationTrackingSpec.cpp

@@ -46,6 +46,9 @@ namespace margelo::nitro::nitrolocationtracking {
       prototype.registerHybridMethod("onProviderStatusChange", &HybridNitroLocationTrackingSpec::onProviderStatusChange);
       prototype.registerHybridMethod("getLocationPermissionStatus", &HybridNitroLocationTrackingSpec::getLocationPermissionStatus);
       prototype.registerHybridMethod("requestLocationPermission", &HybridNitroLocationTrackingSpec::requestLocationPermission);
+      prototype.registerHybridMethod("onPermissionStatusChange", &HybridNitroLocationTrackingSpec::onPermissionStatusChange);
+      prototype.registerHybridMethod("getDistanceBetween", &HybridNitroLocationTrackingSpec::getDistanceBetween);
+      prototype.registerHybridMethod("getDistanceToGeofence", &HybridNitroLocationTrackingSpec::getDistanceToGeofence);
       prototype.registerHybridMethod("showLocalNotification", &HybridNitroLocationTrackingSpec::showLocalNotification);
       prototype.registerHybridMethod("updateForegroundNotification", &HybridNitroLocationTrackingSpec::updateForegroundNotification);
       prototype.registerHybridMethod("destroy", &HybridNitroLocationTrackingSpec::destroy);

package/nitrogen/generated/shared/c++/HybridNitroLocationTrackingSpec.hpp

@@ -114,6 +114,9 @@ namespace margelo::nitro::nitrolocationtracking {
       virtual void onProviderStatusChange(const std::function<void(LocationProviderStatus /* gps */, LocationProviderStatus /* network */)>& callback) = 0;
       virtual PermissionStatus getLocationPermissionStatus() = 0;
       virtual std::shared_ptr<Promise<PermissionStatus>> requestLocationPermission() = 0;
+      virtual void onPermissionStatusChange(const std::function<void(PermissionStatus /* status */)>& callback) = 0;
+      virtual double getDistanceBetween(double lat1, double lon1, double lat2, double lon2) = 0;
+      virtual double getDistanceToGeofence(const std::string& regionId) = 0;
       virtual void showLocalNotification(const std::string& title, const std::string& body) = 0;
       virtual void updateForegroundNotification(const std::string& title, const std::string& body) = 0;
       virtual void destroy() = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-nitro-location-tracking",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "A React Native Nitro module for location tracking",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/NitroLocationTracking.nitro.ts

@@ -89,6 +89,8 @@ export type PermissionStatus =
   | 'whenInUse'
   | 'always';
 
+export type PermissionStatusCallback = (status: PermissionStatus) => void;
+
 // ─── Hybrid Object ──────────────────────────────────
 
 export interface NitroLocationTracking
@@ -144,6 +146,16 @@ export interface NitroLocationTracking
   // === Permission Status ===
   getLocationPermissionStatus(): PermissionStatus;
   requestLocationPermission(): Promise<PermissionStatus>;
+  onPermissionStatusChange(callback: PermissionStatusCallback): void;
+
+  // === Distance Utilities ===
+  getDistanceBetween(
+    lat1: number,
+    lon1: number,
+    lat2: number,
+    lon2: number
+  ): number; // meters
+  getDistanceToGeofence(regionId: string): number; // meters from last known location to geofence center, -1 if not found
 
   // === Notifications ===
   showLocalNotification(title: string, body: string): void;

package/src/index.tsx

@@ -32,6 +32,7 @@ export type {
   LocationProviderStatus,
   ProviderStatusCallback,
   PermissionStatus,
+  PermissionStatusCallback,
 } from './NitroLocationTracking.nitro';
 
 export function useDriverLocation(config: LocationConfig) {