react-native-nitro-location-tracking 0.1.0 → 0.1.2

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

@@ -26,13 +26,15 @@ class LocationForegroundService : Service() {
             (getSystemService(NOTIFICATION_SERVICE) as NotificationManager)
                 .createNotificationChannel(channel)
         }
+        // Must call startForeground immediately to avoid ForegroundServiceDidNotStartInTimeException
+        startForeground(NOTIFICATION_ID, buildNotification("Location Active", "Tracking your location"))
     }
 
     override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
         val title = intent?.getStringExtra("title") ?: "Location Active"
         val text = intent?.getStringExtra("text") ?: "Tracking your location"
         when (intent?.action) {
-            ACTION_START -> startForeground(
+            ACTION_START, null -> startForeground(
                 NOTIFICATION_ID, buildNotification(title, text))
             ACTION_STOP -> {
                 stopForeground(STOP_FOREGROUND_REMOVE)

package/ios/LocationEngine.swift

@@ -48,9 +48,26 @@ class LocationEngine: NSObject, CLLocationManagerDelegate {
     var isTracking: Bool { tracking }
 
     func getCurrentLocation(completion: @escaping (LocationData?) -> Void) {
-        locationManager.requestLocation()
-        // Store completion for delegate callback
+        // If we already have a recent location, return it immediately
+        if let lastLocation = locationManager.location {
+            let age: TimeInterval = Swift.abs(lastLocation.timestamp.timeIntervalSinceNow)
+            if age < 10.0 {
+                let data = LocationData(
+                    latitude: lastLocation.coordinate.latitude,
+                    longitude: lastLocation.coordinate.longitude,
+                    altitude: lastLocation.altitude,
+                    speed: max(lastLocation.speed, 0),
+                    bearing: max(lastLocation.course, 0),
+                    accuracy: lastLocation.horizontalAccuracy,
+                    timestamp: lastLocation.timestamp.timeIntervalSince1970 * 1000
+                )
+                completion(data)
+                return
+            }
+        }
+        // Otherwise request a fresh location
         pendingLocationCompletion = completion
+        locationManager.requestLocation()
     }
 
     private var pendingLocationCompletion: ((LocationData?) -> Void)?
@@ -97,50 +114,3 @@ class LocationEngine: NSObject, CLLocationManagerDelegate {
     }
 }
 
-//// Simple struct to pass location data between components
-//struct LocationData {
-//    let latitude: Double
-//    let longitude: Double
-//    let altitude: Double
-//    let speed: Double
-//    let bearing: Double
-//    let accuracy: Double
-//    let timestamp: Double
-//
-//    var id: String = ""
-//
-//    func toJSON() -> [String: Any] {
-//        return [
-//            "latitude": latitude,
-//            "longitude": longitude,
-//            "altitude": altitude,
-//            "speed": speed,
-//            "bearing": bearing,
-//            "accuracy": accuracy,
-//            "timestamp": timestamp
-//        ]
-//    }
-//}
-//
-//// Config structs
-//struct LocationConfig {
-//    let desiredAccuracy: String
-//    let distanceFilter: Double
-//    let intervalMs: Double
-//    let fastestIntervalMs: Double
-//    let stopTimeout: Double
-//    let stopOnTerminate: Bool
-//    let startOnBoot: Bool
-//    let foregroundNotificationTitle: String
-//    let foregroundNotificationText: String
-//}
-//
-//struct ConnectionConfig {
-//    let wsUrl: String
-//    let restUrl: String
-//    let authToken: String
-//    let reconnectIntervalMs: Double
-//    let maxReconnectAttempts: Double
-//    let batchSize: Double
-//    let syncIntervalMs: Double
-//}

package/lib/module/LocationSmoother.js

@@ -4,10 +4,18 @@ const sleep = ms => new Promise(r => setTimeout(r, ms));
 export class LocationSmoother {
   queue = [];
   isAnimating = false;
+  hasInitialCoordinate = false;
   constructor(markerRef) {
     this.markerRef = markerRef;
   }
   feed(location) {
+    // Skip the first location — let the Marker mount with it as its
+    // initial `coordinate` prop. Calling animateMarkerToCoordinate before
+    // the native marker has a position causes a NullPointerException.
+    if (!this.hasInitialCoordinate) {
+      this.hasInitialCoordinate = true;
+      return;
+    }
     this.queue.push(location);
     if (this.queue.length > 10) this.queue = this.queue.slice(-3);
     if (!this.isAnimating) this.drain();
@@ -28,6 +36,7 @@ export class LocationSmoother {
   clear() {
     this.queue = [];
     this.isAnimating = false;
+    this.hasInitialCoordinate = false;
   }
 }
 //# sourceMappingURL=LocationSmoother.js.map

package/lib/module/LocationSmoother.js.map

@@ -1 +1 @@
-{"version":3,"names":["sleep","ms","Promise","r","setTimeout","LocationSmoother","queue","isAnimating","constructor","markerRef","feed","location","push","length","slice","drain","next","shift","dur","current","animateMarkerToCoordinate","latitude","longitude","clear"],"sourceRoot":"../../src","sources":["LocationSmoother.ts"],"mappings":";;AAEA,MAAMA,KAAK,GAAIC,EAAU,IAAK,IAAIC,OAAO,CAAQC,CAAC,IAAKC,UAAU,CAACD,CAAC,EAAEF,EAAE,CAAC,CAAC;AASzE,OAAO,MAAMI,gBAAgB,CAAC;EACpBC,KAAK,GAAmB,EAAE;EAC1BC,WAAW,GAAG,KAAK;EAG3BC,WAAWA,CAACC,SAAwC,EAAE;IACpD,IAAI,CAACA,SAAS,GAAGA,SAAS;EAC5B;EAEAC,IAAIA,CAACC,QAAsB,EAAE;IAC3B,IAAI,CAACL,KAAK,CAACM,IAAI,CAACD,QAAQ,CAAC;IACzB,IAAI,IAAI,CAACL,KAAK,CAACO,MAAM,GAAG,EAAE,EAAE,IAAI,CAACP,KAAK,GAAG,IAAI,CAACA,KAAK,CAACQ,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7D,IAAI,CAAC,IAAI,CAACP,WAAW,EAAE,IAAI,CAACQ,KAAK,CAAC,CAAC;EACrC;EAEA,MAAcA,KAAKA,CAAA,EAAG;IACpB,IAAI,CAACR,WAAW,GAAG,IAAI;IACvB,OAAO,IAAI,CAACD,KAAK,CAACO,MAAM,GAAG,CAAC,EAAE;MAC5B,MAAMG,IAAI,GAAG,IAAI,CAACV,KAAK,CAACW,KAAK,CAAC,CAAE;MAChC,MAAMC,GAAG,GACP,IAAI,CAACZ,KAAK,CAACO,MAAM,GAAG,CAAC,GAAG,GAAG,GAAG,IAAI,CAACP,KAAK,CAACO,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI;MACnE,IAAI,CAACJ,SAAS,CAACU,OAAO,EAAEC,yBAAyB,CAC/C;QAAEC,QAAQ,EAAEL,IAAI,CAACK,QAAQ;QAAEC,SAAS,EAAEN,IAAI,CAACM;MAAU,CAAC,EACtDJ,GACF,CAAC;MACD,MAAMlB,KAAK,CAACkB,GAAG,GAAG,GAAG,CAAC;IACxB;IACA,IAAI,CAACX,WAAW,GAAG,KAAK;EAC1B;EAEAgB,KAAKA,CAAA,EAAG;IACN,IAAI,CAACjB,KAAK,GAAG,EAAE;IACf,IAAI,CAACC,WAAW,GAAG,KAAK;EAC1B;AACF","ignoreList":[]}
+{"version":3,"names":["sleep","ms","Promise","r","setTimeout","LocationSmoother","queue","isAnimating","hasInitialCoordinate","constructor","markerRef","feed","location","push","length","slice","drain","next","shift","dur","current","animateMarkerToCoordinate","latitude","longitude","clear"],"sourceRoot":"../../src","sources":["LocationSmoother.ts"],"mappings":";;AAEA,MAAMA,KAAK,GAAIC,EAAU,IAAK,IAAIC,OAAO,CAAQC,CAAC,IAAKC,UAAU,CAACD,CAAC,EAAEF,EAAE,CAAC,CAAC;AASzE,OAAO,MAAMI,gBAAgB,CAAC;EACpBC,KAAK,GAAmB,EAAE;EAC1BC,WAAW,GAAG,KAAK;EAEnBC,oBAAoB,GAAG,KAAK;EAEpCC,WAAWA,CAACC,SAAwC,EAAE;IACpD,IAAI,CAACA,SAAS,GAAGA,SAAS;EAC5B;EAEAC,IAAIA,CAACC,QAAsB,EAAE;IAC3B;IACA;IACA;IACA,IAAI,CAAC,IAAI,CAACJ,oBAAoB,EAAE;MAC9B,IAAI,CAACA,oBAAoB,GAAG,IAAI;MAChC;IACF;IAEA,IAAI,CAACF,KAAK,CAACO,IAAI,CAACD,QAAQ,CAAC;IACzB,IAAI,IAAI,CAACN,KAAK,CAACQ,MAAM,GAAG,EAAE,EAAE,IAAI,CAACR,KAAK,GAAG,IAAI,CAACA,KAAK,CAACS,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7D,IAAI,CAAC,IAAI,CAACR,WAAW,EAAE,IAAI,CAACS,KAAK,CAAC,CAAC;EACrC;EAEA,MAAcA,KAAKA,CAAA,EAAG;IACpB,IAAI,CAACT,WAAW,GAAG,IAAI;IACvB,OAAO,IAAI,CAACD,KAAK,CAACQ,MAAM,GAAG,CAAC,EAAE;MAC5B,MAAMG,IAAI,GAAG,IAAI,CAACX,KAAK,CAACY,KAAK,CAAC,CAAE;MAChC,MAAMC,GAAG,GACP,IAAI,CAACb,KAAK,CAACQ,MAAM,GAAG,CAAC,GAAG,GAAG,GAAG,IAAI,CAACR,KAAK,CAACQ,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI;MACnE,IAAI,CAACJ,SAAS,CAACU,OAAO,EAAEC,yBAAyB,CAC/C;QAAEC,QAAQ,EAAEL,IAAI,CAACK,QAAQ;QAAEC,SAAS,EAAEN,IAAI,CAACM;MAAU,CAAC,EACtDJ,GACF,CAAC;MACD,MAAMnB,KAAK,CAACmB,GAAG,GAAG,GAAG,CAAC;IACxB;IACA,IAAI,CAACZ,WAAW,GAAG,KAAK;EAC1B;EAEAiB,KAAKA,CAAA,EAAG;IACN,IAAI,CAAClB,KAAK,GAAG,EAAE;IACf,IAAI,CAACC,WAAW,GAAG,KAAK;IACxB,IAAI,CAACC,oBAAoB,GAAG,KAAK;EACnC;AACF","ignoreList":[]}

package/lib/module/index.js

@@ -4,6 +4,7 @@ import { useState, useEffect, useCallback, useRef } from 'react';
 import { NitroModules } from 'react-native-nitro-modules';
 const NitroLocationModule = NitroModules.createHybridObject('NitroLocationTracking');
 export default NitroLocationModule;
+export { requestLocationPermission } from "./requestPermission.js";
 export { LocationSmoother } from "./LocationSmoother.js";
 export { shortestRotation, calculateBearing } from "./bearing.js";
 // export * from './db'

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["useState","useEffect","useCallback","useRef","NitroModules","NitroLocationModule","createHybridObject","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/module/requestPermission.js

@@ -0,0 +1,38 @@
+"use strict";
+
+import { PermissionsAndroid, Platform } from 'react-native';
+export async function requestLocationPermission(locationPermissionMessage, locationPermissionBackground) {
+  if (Platform.OS === 'ios') {
+    // iOS permissions are handled via Info.plist + system prompt on first access
+    return true;
+  }
+  const fineGranted = await PermissionsAndroid.request(PermissionsAndroid.PERMISSIONS.ACCESS_FINE_LOCATION, {
+    title: locationPermissionMessage?.title ?? 'Location Permission',
+    message: locationPermissionMessage?.message ?? 'This app needs access to your location to track your ride.',
+    buttonPositive: locationPermissionMessage?.buttonPositive ?? 'Allow',
+    buttonNegative: locationPermissionMessage?.buttonNegative ?? 'Deny'
+  });
+  if (fineGranted !== PermissionsAndroid.RESULTS.GRANTED) {
+    return false;
+  }
+
+  // Request background location (required for Android 10+)
+  if (Number(Platform.Version) >= 29) {
+    const bgGranted = await PermissionsAndroid.request(PermissionsAndroid.PERMISSIONS.ACCESS_BACKGROUND_LOCATION, {
+      title: locationPermissionBackground?.title ?? 'Background Location Permission',
+      message: locationPermissionBackground?.message ?? 'This app needs background location access to continue tracking while the app is minimized.',
+      buttonPositive: locationPermissionBackground?.buttonPositive ?? 'Allow',
+      buttonNegative: locationPermissionBackground?.buttonNegative ?? 'Deny'
+    });
+    if (bgGranted !== PermissionsAndroid.RESULTS.GRANTED) {
+      return false;
+    }
+  }
+
+  // Request notification permission (required for Android 13+)
+  if (Number(Platform.Version) >= 33) {
+    await PermissionsAndroid.request(PermissionsAndroid.PERMISSIONS.POST_NOTIFICATIONS);
+  }
+  return true;
+}
+//# sourceMappingURL=requestPermission.js.map

package/lib/module/requestPermission.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["PermissionsAndroid","Platform","requestLocationPermission","locationPermissionMessage","locationPermissionBackground","OS","fineGranted","request","PERMISSIONS","ACCESS_FINE_LOCATION","title","message","buttonPositive","buttonNegative","RESULTS","GRANTED","Number","Version","bgGranted","ACCESS_BACKGROUND_LOCATION","POST_NOTIFICATIONS"],"sourceRoot":"../../src","sources":["requestPermission.ts"],"mappings":";;AAAA,SAASA,kBAAkB,EAAEC,QAAQ,QAAQ,cAAc;AAE3D,OAAO,eAAeC,yBAAyBA,CAC7CC,yBAOC,EACDC,4BAOC,EACiB;EAClB,IAAIH,QAAQ,CAACI,EAAE,KAAK,KAAK,EAAE;IACzB;IACA,OAAO,IAAI;EACb;EAEA,MAAMC,WAAW,GAAG,MAAMN,kBAAkB,CAACO,OAAO,CAClDP,kBAAkB,CAACQ,WAAW,CAACC,oBAAoB,EACnD;IACEC,KAAK,EAAEP,yBAAyB,EAAEO,KAAK,IAAI,qBAAqB;IAChEC,OAAO,EACLR,yBAAyB,EAAEQ,OAAO,IAClC,4DAA4D;IAC9DC,cAAc,EAAET,yBAAyB,EAAES,cAAc,IAAI,OAAO;IACpEC,cAAc,EAAEV,yBAAyB,EAAEU,cAAc,IAAI;EAC/D,CACF,CAAC;EAED,IAAIP,WAAW,KAAKN,kBAAkB,CAACc,OAAO,CAACC,OAAO,EAAE;IACtD,OAAO,KAAK;EACd;;EAEA;EACA,IAAIC,MAAM,CAACf,QAAQ,CAACgB,OAAO,CAAC,IAAI,EAAE,EAAE;IAClC,MAAMC,SAAS,GAAG,MAAMlB,kBAAkB,CAACO,OAAO,CAChDP,kBAAkB,CAACQ,WAAW,CAACW,0BAA0B,EACzD;MACET,KAAK,EACHN,4BAA4B,EAAEM,KAAK,IACnC,gCAAgC;MAClCC,OAAO,EACLP,4BAA4B,EAAEO,OAAO,IACrC,4FAA4F;MAC9FC,cAAc,EAAER,4BAA4B,EAAEQ,cAAc,IAAI,OAAO;MACvEC,cAAc,EAAET,4BAA4B,EAAES,cAAc,IAAI;IAClE,CACF,CAAC;IAED,IAAIK,SAAS,KAAKlB,kBAAkB,CAACc,OAAO,CAACC,OAAO,EAAE;MACpD,OAAO,KAAK;IACd;EACF;;EAEA;EACA,IAAIC,MAAM,CAACf,QAAQ,CAACgB,OAAO,CAAC,IAAI,EAAE,EAAE;IAClC,MAAMjB,kBAAkB,CAACO,OAAO,CAC9BP,kBAAkB,CAACQ,WAAW,CAACY,kBACjC,CAAC;EACH;EAEA,OAAO,IAAI;AACb","ignoreList":[]}

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

@@ -9,6 +9,7 @@ export declare class LocationSmoother {
     private queue;
     private isAnimating;
     private markerRef;
+    private hasInitialCoordinate;
     constructor(markerRef: {
         current: MarkerRef | null;
     });

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

@@ -1 +1 @@
-{"version":3,"file":"LocationSmoother.d.ts","sourceRoot":"","sources":["../../../src/LocationSmoother.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAIlE,MAAM,WAAW,SAAS;IACxB,yBAAyB,CACvB,UAAU,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EACnD,QAAQ,EAAE,MAAM,GACf,IAAI,CAAC;CACT;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAgC;gBAErC,SAAS,EAAE;QAAE,OAAO,EAAE,SAAS,GAAG,IAAI,CAAA;KAAE;IAIpD,IAAI,CAAC,QAAQ,EAAE,YAAY;YAMb,KAAK;IAenB,KAAK;CAIN"}
+{"version":3,"file":"LocationSmoother.d.ts","sourceRoot":"","sources":["../../../src/LocationSmoother.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAIlE,MAAM,WAAW,SAAS;IACxB,yBAAyB,CACvB,UAAU,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EACnD,QAAQ,EAAE,MAAM,GACf,IAAI,CAAC;CACT;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,oBAAoB,CAAS;gBAEzB,SAAS,EAAE;QAAE,OAAO,EAAE,SAAS,GAAG,IAAI,CAAA;KAAE;IAIpD,IAAI,CAAC,QAAQ,EAAE,YAAY;YAcb,KAAK;IAenB,KAAK;CAKN"}

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

@@ -1,6 +1,7 @@
 import type { NitroLocationTracking, LocationData, LocationConfig, ConnectionConfig } from './NitroLocationTracking.nitro';
 declare const NitroLocationModule: NitroLocationTracking;
 export default NitroLocationModule;
+export { requestLocationPermission } from './requestPermission';
 export { LocationSmoother } from './LocationSmoother';
 export { shortestRotation, calculateBearing } from './bearing';
 export type { NitroLocationTracking, LocationData, LocationConfig, ConnectionConfig, } from './NitroLocationTracking.nitro';

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,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,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,GACjB,MAAM,+BAA+B,CAAC;AAEvC,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc;;;;;;EAuCvD;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB;;;;;cAuBhC,MAAM;EAE/B"}

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

@@ -0,0 +1,12 @@
+export declare function requestLocationPermission(locationPermissionMessage?: {
+    title: string | 'Location Permission';
+    message: string | 'This app needs access to your location to track your ride.';
+    buttonPositive: string | 'Allow';
+    buttonNegative: string | 'Deny';
+}, locationPermissionBackground?: {
+    title: string | 'Background Location Permission';
+    message: string | 'This app needs background location access to continue tracking while the app is minimized.';
+    buttonPositive: string | 'Allow';
+    buttonNegative: string | 'Deny';
+}): Promise<boolean>;
+//# sourceMappingURL=requestPermission.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"requestPermission.d.ts","sourceRoot":"","sources":["../../../src/requestPermission.ts"],"names":[],"mappings":"AAEA,wBAAsB,yBAAyB,CAC7C,yBAAyB,CAAC,EAAE;IAC1B,KAAK,EAAE,MAAM,GAAG,qBAAqB,CAAC;IACtC,OAAO,EACH,MAAM,GACN,4DAA4D,CAAC;IACjE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC;IACjC,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC;CACjC,EACD,4BAA4B,CAAC,EAAE;IAC7B,KAAK,EAAE,MAAM,GAAG,gCAAgC,CAAC;IACjD,OAAO,EACH,MAAM,GACN,4FAA4F,CAAC;IACjG,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC;IACjC,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC;CACjC,GACA,OAAO,CAAC,OAAO,CAAC,CAmDlB"}

package/package.json

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

package/src/LocationSmoother.ts

@@ -13,12 +13,21 @@ export class LocationSmoother {
   private queue: LocationData[] = [];
   private isAnimating = false;
   private markerRef: { current: MarkerRef | null };
+  private hasInitialCoordinate = false;
 
   constructor(markerRef: { current: MarkerRef | null }) {
     this.markerRef = markerRef;
   }
 
   feed(location: LocationData) {
+    // Skip the first location — let the Marker mount with it as its
+    // initial `coordinate` prop. Calling animateMarkerToCoordinate before
+    // the native marker has a position causes a NullPointerException.
+    if (!this.hasInitialCoordinate) {
+      this.hasInitialCoordinate = true;
+      return;
+    }
+
     this.queue.push(location);
     if (this.queue.length > 10) this.queue = this.queue.slice(-3);
     if (!this.isAnimating) this.drain();
@@ -42,5 +51,6 @@ export class LocationSmoother {
   clear() {
     this.queue = [];
     this.isAnimating = false;
+    this.hasInitialCoordinate = false;
   }
 }

package/src/index.tsx

@@ -13,6 +13,7 @@ const NitroLocationModule =
   );
 
 export default NitroLocationModule;
+export { requestLocationPermission } from './requestPermission';
 export { LocationSmoother } from './LocationSmoother';
 export { shortestRotation, calculateBearing } from './bearing';
 // export * from './db'

package/src/requestPermission.ts

@@ -0,0 +1,71 @@
+import { PermissionsAndroid, Platform } from 'react-native';
+
+export async function requestLocationPermission(
+  locationPermissionMessage?: {
+    title: string | 'Location Permission';
+    message:
+      | string
+      | 'This app needs access to your location to track your ride.';
+    buttonPositive: string | 'Allow';
+    buttonNegative: string | 'Deny';
+  },
+  locationPermissionBackground?: {
+    title: string | 'Background Location Permission';
+    message:
+      | string
+      | 'This app needs background location access to continue tracking while the app is minimized.';
+    buttonPositive: string | 'Allow';
+    buttonNegative: string | 'Deny';
+  }
+): Promise<boolean> {
+  if (Platform.OS === 'ios') {
+    // iOS permissions are handled via Info.plist + system prompt on first access
+    return true;
+  }
+
+  const fineGranted = await PermissionsAndroid.request(
+    PermissionsAndroid.PERMISSIONS.ACCESS_FINE_LOCATION,
+    {
+      title: locationPermissionMessage?.title ?? 'Location Permission',
+      message:
+        locationPermissionMessage?.message ??
+        'This app needs access to your location to track your ride.',
+      buttonPositive: locationPermissionMessage?.buttonPositive ?? 'Allow',
+      buttonNegative: locationPermissionMessage?.buttonNegative ?? 'Deny',
+    }
+  );
+
+  if (fineGranted !== PermissionsAndroid.RESULTS.GRANTED) {
+    return false;
+  }
+
+  // Request background location (required for Android 10+)
+  if (Number(Platform.Version) >= 29) {
+    const bgGranted = await PermissionsAndroid.request(
+      PermissionsAndroid.PERMISSIONS.ACCESS_BACKGROUND_LOCATION,
+      {
+        title:
+          locationPermissionBackground?.title ??
+          'Background Location Permission',
+        message:
+          locationPermissionBackground?.message ??
+          'This app needs background location access to continue tracking while the app is minimized.',
+        buttonPositive: locationPermissionBackground?.buttonPositive ?? 'Allow',
+        buttonNegative: locationPermissionBackground?.buttonNegative ?? 'Deny',
+      }
+    );
+
+    if (bgGranted !== PermissionsAndroid.RESULTS.GRANTED) {
+      return false;
+    }
+  }
+
+  // Request notification permission (required for Android 13+)
+  if (Number(Platform.Version) >= 33) {
+    await PermissionsAndroid.request(
+      PermissionsAndroid.PERMISSIONS.POST_NOTIFICATIONS
+    );
+  }
+
+  return true;
+}