react-native-nitro-location-tracking 0.1.7 → 0.1.9

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,55 @@ 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.                  |
 
 ## API Reference
 
@@ -453,11 +542,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 +555,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 +575,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 +587,7 @@ interface GeofenceRegion {
   id: string;
   latitude: number;
   longitude: number;
-  radius: number;          // meters
+  radius: number; // meters
   notifyOnEntry: boolean;
   notifyOnExit: boolean;
 }
@@ -508,9 +597,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 +628,61 @@ 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                              |
+| `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/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

@@ -1,7 +1,11 @@
 package com.margelo.nitro.nitrolocationtracking
 
+import android.content.pm.PackageManager
 import android.util.Log
+import androidx.core.app.ActivityCompat
+import androidx.core.content.ContextCompat
 import com.facebook.proguard.annotations.DoNotStrip
+import com.facebook.react.bridge.ReactContext
 import com.margelo.nitro.NitroModules
 import com.margelo.nitro.core.Promise
 import kotlin.coroutines.resume
@@ -13,6 +17,7 @@ class NitroLocationTracking : HybridNitroLocationTrackingSpec() {
 
     companion object {
         private const val TAG = "NitroLocationTracking"
+        private const val PERMISSION_REQUEST_CODE = 9001
     }
 
     private var locationEngine: LocationEngine? = null
@@ -32,6 +37,7 @@ class NitroLocationTracking : HybridNitroLocationTrackingSpec() {
 
     private var locationConfig: LocationConfig? = null
 
+
     private fun ensureInitialized(): Boolean {
         if (locationEngine != null) return true
         val context = NitroModules.applicationContext
@@ -260,22 +266,19 @@ class NitroLocationTracking : HybridNitroLocationTrackingSpec() {
     override fun getLocationPermissionStatus(): PermissionStatus {
         val context = NitroModules.applicationContext ?: return PermissionStatus.NOTDETERMINED
 
-        val fineGranted = androidx.core.content.ContextCompat.checkSelfPermission(
+        val fineGranted = ContextCompat.checkSelfPermission(
             context, android.Manifest.permission.ACCESS_FINE_LOCATION
-        ) == android.content.pm.PackageManager.PERMISSION_GRANTED
+        ) == PackageManager.PERMISSION_GRANTED
 
         if (!fineGranted) {
-            // Check if we've ever asked — if the app just installed, it's "notDetermined"
-            // Android doesn't have a direct "notDetermined" state, so we treat
-            // not-granted as DENIED (the JS side can use requestPermission to prompt)
             return PermissionStatus.DENIED
         }
 
         // Fine location granted — check background
         if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.Q) {
-            val bgGranted = androidx.core.content.ContextCompat.checkSelfPermission(
+            val bgGranted = ContextCompat.checkSelfPermission(
                 context, android.Manifest.permission.ACCESS_BACKGROUND_LOCATION
-            ) == android.content.pm.PackageManager.PERMISSION_GRANTED
+            ) == PackageManager.PERMISSION_GRANTED
             return if (bgGranted) PermissionStatus.ALWAYS else PermissionStatus.WHENINUSE
         }
 
@@ -283,6 +286,79 @@ class NitroLocationTracking : HybridNitroLocationTrackingSpec() {
         return PermissionStatus.ALWAYS
     }
 
+    override fun requestLocationPermission(): Promise<PermissionStatus> {
+        return Promise.async {
+            suspendCoroutine { cont ->
+                val context = NitroModules.applicationContext
+                if (context == null) {
+                    cont.resume(PermissionStatus.DENIED)
+                    return@suspendCoroutine
+                }
+
+                // Already granted — return current status immediately
+                val fineGranted = ContextCompat.checkSelfPermission(
+                    context, android.Manifest.permission.ACCESS_FINE_LOCATION
+                ) == PackageManager.PERMISSION_GRANTED
+
+                if (fineGranted) {
+                    cont.resume(getLocationPermissionStatus())
+                    return@suspendCoroutine
+                }
+
+                // Need to request — get the current Activity
+                val activity = (context as? ReactContext)?.currentActivity
+                if (activity == null) {
+                    Log.e(TAG, "requestLocationPermission — no current Activity available")
+                    cont.resume(PermissionStatus.DENIED)
+                    return@suspendCoroutine
+                }
+
+                // Use PermissionAwareActivity if available (React Native's Activity)
+                if (activity is com.facebook.react.modules.core.PermissionAwareActivity) {
+                    activity.requestPermissions(
+                        arrayOf(
+                            android.Manifest.permission.ACCESS_FINE_LOCATION,
+                            android.Manifest.permission.ACCESS_COARSE_LOCATION
+                        ),
+                        PERMISSION_REQUEST_CODE
+                    ) { requestCode, _, _ ->
+                        if (requestCode == PERMISSION_REQUEST_CODE) {
+                            cont.resume(getLocationPermissionStatus())
+                        }
+                        true // PermissionListener requires Boolean return
+                    }
+                } else {
+                    // Fallback: use ActivityCompat (result won't be captured directly)
+                    ActivityCompat.requestPermissions(
+                        activity,
+                        arrayOf(
+                            android.Manifest.permission.ACCESS_FINE_LOCATION,
+                            android.Manifest.permission.ACCESS_COARSE_LOCATION
+                        ),
+                        PERMISSION_REQUEST_CODE
+                    )
+                    // Poll for result after user interacts with the dialog
+                    android.os.Handler(android.os.Looper.getMainLooper()).postDelayed({
+                        cont.resume(getLocationPermissionStatus())
+                    }, 5000)
+                }
+            }
+        }
+    }
+
+    // === 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) {

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

@@ -11,6 +11,8 @@ class LocationEngine: NSObject, CLLocationManagerDelegate {
         return mgr
     }()
     private var tracking = false
+    private var pendingPermissionCompletion: ((CLAuthorizationStatus) -> Void)?
+    private var pendingStartAfterPermission = false
 
     var onLocation: ((LocationData) -> Void)?
     var onMotionChange: ((Bool) -> Void)?
@@ -21,6 +23,11 @@ class LocationEngine: NSObject, CLLocationManagerDelegate {
     let tripCalculator = TripCalculator()
     var providerStatusCallback: ((LocationProviderStatus, LocationProviderStatus) -> Void)?
 
+    /// The most recently received location from Core Location (for distance calculations)
+    var lastCLLocation: CLLocation? {
+        return locationManager.location
+    }
+
     override init() {
         super.init()
         locationManager.delegate = self
@@ -45,6 +52,7 @@ class LocationEngine: NSObject, CLLocationManagerDelegate {
     func start() {
         guard CLLocationManager.authorizationStatus() == .authorizedAlways ||
               CLLocationManager.authorizationStatus() == .authorizedWhenInUse else {
+            pendingStartAfterPermission = true
             locationManager.requestAlwaysAuthorization()
             return
         }
@@ -52,10 +60,21 @@ class LocationEngine: NSObject, CLLocationManagerDelegate {
         tracking = true
     }
 
+    func requestPermission(completion: @escaping (CLAuthorizationStatus) -> Void) {
+        let currentStatus = CLLocationManager.authorizationStatus()
+        if currentStatus != .notDetermined {
+            completion(currentStatus)
+            return
+        }
+        pendingPermissionCompletion = completion
+        locationManager.requestAlwaysAuthorization()
+    }
+
     func stop() {
         locationManager.stopUpdatingLocation()
         tracking = false
     }
+  
 
     var isTracking: Bool { tracking }
 
@@ -80,11 +99,11 @@ class LocationEngine: NSObject, CLLocationManagerDelegate {
         }
         // Use a SEPARATE manager for one-shot requests so we never
         // stop the continuous startUpdatingLocation() on locationManager.
-        pendingLocationCompletion = completion
+        pendingLocationCompletions.append(completion)
         oneShotManager.requestLocation()
     }
 
-    private var pendingLocationCompletion: ((LocationData?) -> Void)?
+    private var pendingLocationCompletions: [(LocationData?) -> Void] = []
 
     func locationManager(_ manager: CLLocationManager,
                          didUpdateLocations locations: [CLLocation]) {
@@ -104,9 +123,12 @@ class LocationEngine: NSObject, CLLocationManagerDelegate {
         )
 
         // Handle pending one-shot request (from oneShotManager)
-        if manager === oneShotManager, let completion = pendingLocationCompletion {
-            completion(data)
-            pendingLocationCompletion = nil
+        if manager === oneShotManager {
+            let completions = pendingLocationCompletions
+            pendingLocationCompletions.removeAll()
+            for completion in completions {
+                completion(data)
+            }
             return
         }
 
@@ -131,9 +153,12 @@ class LocationEngine: NSObject, CLLocationManagerDelegate {
 
     func locationManager(_ manager: CLLocationManager,
                          didFailWithError error: Error) {
-        if manager === oneShotManager, let completion = pendingLocationCompletion {
-            completion(nil)
-            pendingLocationCompletion = nil
+        if manager === oneShotManager {
+            let completions = pendingLocationCompletions
+            pendingLocationCompletions.removeAll()
+            for completion in completions {
+                completion(nil)
+            }
         }
     }
 
@@ -169,6 +194,24 @@ class LocationEngine: NSObject, CLLocationManagerDelegate {
 
     func locationManagerDidChangeAuthorization(_ manager: CLLocationManager) {
         guard manager === locationManager else { return }
+
+        let authStatus = CLLocationManager.authorizationStatus()
+
+        // Resolve pending permission request
+        if let completion = pendingPermissionCompletion {
+            pendingPermissionCompletion = nil
+            completion(authStatus)
+        }
+
+        // Auto-start tracking if permission was granted after start() was called
+        if pendingStartAfterPermission {
+            pendingStartAfterPermission = false
+            if authStatus == .authorizedAlways || authStatus == .authorizedWhenInUse {
+                locationManager.startUpdatingLocation()
+                tracking = true
+            }
+        }
+
         let enabled = CLLocationManager.locationServicesEnabled()
         let status: LocationProviderStatus = enabled ? .enabled : .disabled
         providerStatusCallback?(status, status)

package/ios/NitroLocationTracking.swift

@@ -3,7 +3,6 @@ import CoreLocation
 import NitroModules
 
 class NitroLocationTracking: HybridNitroLocationTrackingSpec {
-
     private let locationEngine = LocationEngine()
     private let connectionManager = ConnectionManager()
     private let dbWriter = NativeDBWriter()
@@ -17,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 permissionPromise: Promise<PermissionStatus>?
 
     override init() {
         super.init()
@@ -44,6 +44,7 @@ class NitroLocationTracking: HybridNitroLocationTrackingSpec {
         locationEngine.stop()
     }
 
+
     func getCurrentLocation() throws -> Promise<LocationData> {
         let promise = Promise<LocationData>()
         locationEngine.getCurrentLocation { data in
@@ -58,7 +59,7 @@ class NitroLocationTracking: HybridNitroLocationTrackingSpec {
         return promise
     }
 
-    func isTracking() throws -> Bool {
+      func isTracking() throws -> Bool {
         return locationEngine.isTracking
     }
 
@@ -212,6 +213,41 @@ class NitroLocationTracking: HybridNitroLocationTrackingSpec {
         }
     }
 
+    func requestLocationPermission() throws -> Promise<PermissionStatus> {
+        let promise = Promise<PermissionStatus>()
+        locationEngine.requestPermission { authStatus in
+            let result: PermissionStatus
+            switch authStatus {
+            case .notDetermined:
+                result = .notdetermined
+            case .restricted:
+                result = .restricted
+            case .denied:
+                result = .denied
+            case .authorizedWhenInUse:
+                result = .wheninuse
+            case .authorizedAlways:
+                result = .always
+            @unknown default:
+                result = .notdetermined
+            }
+            promise.resolve(withResult: result)
+        }
+        return promise
+    }
+
+    // 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/typescript/src/NitroLocationTracking.nitro.d.ts

@@ -96,6 +96,9 @@ export interface NitroLocationTracking extends HybridObject<{
     isLocationServicesEnabled(): boolean;
     onProviderStatusChange(callback: ProviderStatusCallback): void;
     getLocationPermissionStatus(): PermissionStatus;
+    requestLocationPermission(): Promise<PermissionStatus>;
+    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/nitrogen/generated/android/c++/JHybridNitroLocationTrackingSpec.cpp

@@ -265,6 +265,32 @@ namespace margelo::nitro::nitrolocationtracking {
     auto __result = method(_javaPart);
     return __result->toCpp();
   }
+  std::shared_ptr<Promise<PermissionStatus>> JHybridNitroLocationTrackingSpec::requestLocationPermission() {
+    static const auto method = javaClassStatic()->getMethod<jni::local_ref<JPromise::javaobject>()>("requestLocationPermission");
+    auto __result = method(_javaPart);
+    return [&]() {
+      auto __promise = Promise<PermissionStatus>::create();
+      __result->cthis()->addOnResolvedListener([=](const jni::alias_ref<jni::JObject>& __boxedResult) {
+        auto __result = jni::static_ref_cast<JPermissionStatus>(__boxedResult);
+        __promise->resolve(__result->toCpp());
+      });
+      __result->cthis()->addOnRejectedListener([=](const jni::alias_ref<jni::JThrowable>& __throwable) {
+        jni::JniException __jniError(__throwable);
+        __promise->reject(std::make_exception_ptr(__jniError));
+      });
+      return __promise;
+    }();
+  }
+  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

@@ -86,6 +86,9 @@ namespace margelo::nitro::nitrolocationtracking {
     bool isLocationServicesEnabled() override;
     void onProviderStatusChange(const std::function<void(LocationProviderStatus /* gps */, LocationProviderStatus /* network */)>& callback) override;
     PermissionStatus getLocationPermissionStatus() override;
+    std::shared_ptr<Promise<PermissionStatus>> requestLocationPermission() 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/HybridNitroLocationTrackingSpec.kt

@@ -205,6 +205,18 @@ abstract class HybridNitroLocationTrackingSpec: HybridObject() {
   @Keep
   abstract fun getLocationPermissionStatus(): PermissionStatus
   
+  @DoNotStrip
+  @Keep
+  abstract fun requestLocationPermission(): Promise<PermissionStatus>
+  
+  @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/ios/NitroLocationTracking-Swift-Cxx-Bridge.cpp

@@ -78,6 +78,14 @@ namespace margelo::nitro::nitrolocationtracking::bridge::swift {
     };
   }
   
+  // pragma MARK: std::function<void(PermissionStatus /* result */)>
+  Func_void_PermissionStatus create_Func_void_PermissionStatus(void* NON_NULL swiftClosureWrapper) noexcept {
+    auto swiftClosure = NitroLocationTracking::Func_void_PermissionStatus::fromUnsafe(swiftClosureWrapper);
+    return [swiftClosure = std::move(swiftClosure)](PermissionStatus result) mutable -> void {
+      swiftClosure.call(static_cast<int>(result));
+    };
+  }
+  
   // pragma MARK: std::shared_ptr<HybridNitroLocationTrackingSpec>
   std::shared_ptr<HybridNitroLocationTrackingSpec> create_std__shared_ptr_HybridNitroLocationTrackingSpec_(void* NON_NULL swiftUnsafePointer) noexcept {
     NitroLocationTracking::HybridNitroLocationTrackingSpec_cxx swiftPart = NitroLocationTracking::HybridNitroLocationTrackingSpec_cxx::fromUnsafe(swiftUnsafePointer);

package/nitrogen/generated/ios/NitroLocationTracking-Swift-Cxx-Bridge.hpp

@@ -268,6 +268,40 @@ namespace margelo::nitro::nitrolocationtracking::bridge::swift {
     return Func_void_LocationProviderStatus_LocationProviderStatus_Wrapper(std::move(value));
   }
   
+  // pragma MARK: std::shared_ptr<Promise<PermissionStatus>>
+  /**
+   * Specialized version of `std::shared_ptr<Promise<PermissionStatus>>`.
+   */
+  using std__shared_ptr_Promise_PermissionStatus__ = std::shared_ptr<Promise<PermissionStatus>>;
+  inline std::shared_ptr<Promise<PermissionStatus>> create_std__shared_ptr_Promise_PermissionStatus__() noexcept {
+    return Promise<PermissionStatus>::create();
+  }
+  inline PromiseHolder<PermissionStatus> wrap_std__shared_ptr_Promise_PermissionStatus__(std::shared_ptr<Promise<PermissionStatus>> promise) noexcept {
+    return PromiseHolder<PermissionStatus>(std::move(promise));
+  }
+  
+  // pragma MARK: std::function<void(PermissionStatus /* result */)>
+  /**
+   * Specialized version of `std::function<void(PermissionStatus)>`.
+   */
+  using Func_void_PermissionStatus = std::function<void(PermissionStatus /* result */)>;
+  /**
+   * Wrapper class for a `std::function<void(PermissionStatus / * result * /)>`, this can be used from Swift.
+   */
+  class Func_void_PermissionStatus_Wrapper final {
+  public:
+    explicit Func_void_PermissionStatus_Wrapper(std::function<void(PermissionStatus /* result */)>&& func): _function(std::make_unique<std::function<void(PermissionStatus /* result */)>>(std::move(func))) {}
+    inline void call(int result) const noexcept {
+      _function->operator()(static_cast<PermissionStatus>(result));
+    }
+  private:
+    std::unique_ptr<std::function<void(PermissionStatus /* result */)>> _function;
+  } SWIFT_NONCOPYABLE;
+  Func_void_PermissionStatus create_Func_void_PermissionStatus(void* NON_NULL swiftClosureWrapper) noexcept;
+  inline Func_void_PermissionStatus_Wrapper wrap_Func_void_PermissionStatus(Func_void_PermissionStatus value) noexcept {
+    return Func_void_PermissionStatus_Wrapper(std::move(value));
+  }
+  
   // pragma MARK: std::shared_ptr<HybridNitroLocationTrackingSpec>
   /**
    * Specialized version of `std::shared_ptr<HybridNitroLocationTrackingSpec>`.
@@ -351,5 +385,14 @@ namespace margelo::nitro::nitrolocationtracking::bridge::swift {
   inline Result_PermissionStatus_ create_Result_PermissionStatus_(const std::exception_ptr& error) noexcept {
     return Result<PermissionStatus>::withError(error);
   }
+  
+  // pragma MARK: Result<std::shared_ptr<Promise<PermissionStatus>>>
+  using Result_std__shared_ptr_Promise_PermissionStatus___ = Result<std::shared_ptr<Promise<PermissionStatus>>>;
+  inline Result_std__shared_ptr_Promise_PermissionStatus___ create_Result_std__shared_ptr_Promise_PermissionStatus___(const std::shared_ptr<Promise<PermissionStatus>>& value) noexcept {
+    return Result<std::shared_ptr<Promise<PermissionStatus>>>::withValue(value);
+  }
+  inline Result_std__shared_ptr_Promise_PermissionStatus___ create_Result_std__shared_ptr_Promise_PermissionStatus___(const std::exception_ptr& error) noexcept {
+    return Result<std::shared_ptr<Promise<PermissionStatus>>>::withError(error);
+  }
 
 } // namespace margelo::nitro::nitrolocationtracking::bridge::swift

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

@@ -310,6 +310,30 @@ namespace margelo::nitro::nitrolocationtracking {
       auto __value = std::move(__result.value());
       return __value;
     }
+    inline std::shared_ptr<Promise<PermissionStatus>> requestLocationPermission() override {
+      auto __result = _swiftPart.requestLocationPermission();
+      if (__result.hasError()) [[unlikely]] {
+        std::rethrow_exception(__result.error());
+      }
+      auto __value = std::move(__result.value());
+      return __value;
+    }
+    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/Func_void_PermissionStatus.swift

@@ -0,0 +1,46 @@
+///
+/// Func_void_PermissionStatus.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+import NitroModules
+
+/**
+ * Wraps a Swift `(_ value: PermissionStatus) -> Void` as a class.
+ * This class can be used from C++, e.g. to wrap the Swift closure as a `std::function`.
+ */
+public final class Func_void_PermissionStatus {
+  public typealias bridge = margelo.nitro.nitrolocationtracking.bridge.swift
+
+  private let closure: (_ value: PermissionStatus) -> Void
+
+  public init(_ closure: @escaping (_ value: PermissionStatus) -> Void) {
+    self.closure = closure
+  }
+
+  @inline(__always)
+  public func call(value: Int32) -> Void {
+    self.closure(margelo.nitro.nitrolocationtracking.PermissionStatus(rawValue: value)!)
+  }
+
+  /**
+   * Casts this instance to a retained unsafe raw pointer.
+   * This acquires one additional strong reference on the object!
+   */
+  @inline(__always)
+  public func toUnsafe() -> UnsafeMutableRawPointer {
+    return Unmanaged.passRetained(self).toOpaque()
+  }
+
+  /**
+   * Casts an unsafe pointer to a `Func_void_PermissionStatus`.
+   * The pointer has to be a retained opaque `Unmanaged<Func_void_PermissionStatus>`.
+   * This removes one strong reference from the object!
+   */
+  @inline(__always)
+  public static func fromUnsafe(_ pointer: UnsafeMutableRawPointer) -> Func_void_PermissionStatus {
+    return Unmanaged<Func_void_PermissionStatus>.fromOpaque(pointer).takeRetainedValue()
+  }
+}

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

@@ -44,6 +44,9 @@ public protocol HybridNitroLocationTrackingSpec_protocol: HybridObject {
   func isLocationServicesEnabled() throws -> Bool
   func onProviderStatusChange(callback: @escaping (_ gps: LocationProviderStatus, _ network: LocationProviderStatus) -> Void) throws -> Void
   func getLocationPermissionStatus() throws -> PermissionStatus
+  func requestLocationPermission() throws -> Promise<PermissionStatus>
+  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

@@ -524,6 +524,49 @@ open class HybridNitroLocationTrackingSpec_cxx {
     }
   }
   
+  @inline(__always)
+  public final func requestLocationPermission() -> bridge.Result_std__shared_ptr_Promise_PermissionStatus___ {
+    do {
+      let __result = try self.__implementation.requestLocationPermission()
+      let __resultCpp = { () -> bridge.std__shared_ptr_Promise_PermissionStatus__ in
+        let __promise = bridge.create_std__shared_ptr_Promise_PermissionStatus__()
+        let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_PermissionStatus__(__promise)
+        __result
+          .then({ __result in __promiseHolder.resolve(__result) })
+          .catch({ __error in __promiseHolder.reject(__error.toCpp()) })
+        return __promise
+      }()
+      return bridge.create_Result_std__shared_ptr_Promise_PermissionStatus___(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__shared_ptr_Promise_PermissionStatus___(__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

@@ -45,6 +45,9 @@ namespace margelo::nitro::nitrolocationtracking {
       prototype.registerHybridMethod("isLocationServicesEnabled", &HybridNitroLocationTrackingSpec::isLocationServicesEnabled);
       prototype.registerHybridMethod("onProviderStatusChange", &HybridNitroLocationTrackingSpec::onProviderStatusChange);
       prototype.registerHybridMethod("getLocationPermissionStatus", &HybridNitroLocationTrackingSpec::getLocationPermissionStatus);
+      prototype.registerHybridMethod("requestLocationPermission", &HybridNitroLocationTrackingSpec::requestLocationPermission);
+      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

@@ -113,6 +113,9 @@ namespace margelo::nitro::nitrolocationtracking {
       virtual bool isLocationServicesEnabled() = 0;
       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 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.7",
+  "version": "0.1.9",
   "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

@@ -143,6 +143,16 @@ export interface NitroLocationTracking
 
   // === Permission Status ===
   getLocationPermissionStatus(): PermissionStatus;
+  requestLocationPermission(): Promise<PermissionStatus>;
+
+  // === 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;