move init to start

Author: Shahroz16

location/src/main/kotlin/io/customer/location/LocationLifecycleObserver.kt

@@ -4,18 +4,30 @@ import androidx.lifecycle.DefaultLifecycleObserver
 import androidx.lifecycle.LifecycleOwner
 
 /**
- * Cancels in-flight location requests when the app enters background.
+ * Manages location lifecycle tied to app foreground/background transitions.
  *
  * Registered with [ProcessLifecycleOwner] during module initialization.
- * [onStop] fires when the app transitions to background — any active
- * GPS request is cancelled to avoid unnecessary work while backgrounded.
+ * - [onStart]: triggers a one-shot location request on the first foreground entry
+ *   when [trackingMode] is [LocationTrackingMode.ON_APP_START].
+ * - [onStop]: cancels any in-flight GPS request when the app enters background.
  *
- * No mutable state — thread safety is inherent.
+ * Thread safety: all lifecycle callbacks are delivered on the main thread
+ * by [ProcessLifecycleOwner], so no synchronization is needed.
  */
 internal class LocationLifecycleObserver(
-    private val locationServices: LocationServicesImpl
+    private val locationServices: LocationServicesImpl,
+    private val trackingMode: LocationTrackingMode
 ) : DefaultLifecycleObserver {
 
+    private var hasRequestedOnStart = false
+
+    override fun onStart(owner: LifecycleOwner) {
+        if (trackingMode == LocationTrackingMode.ON_APP_START && !hasRequestedOnStart) {
+            hasRequestedOnStart = true
+            locationServices.requestLocationUpdate()
+        }
+    }
+
     override fun onStop(owner: LifecycleOwner) {
         locationServices.cancelInFlightRequest()
     }

location/src/main/kotlin/io/customer/location/ModuleLocation.kt

@@ -120,22 +120,17 @@ class ModuleLocation @JvmOverloads constructor(
             }
         }
 
-        // Cancel in-flight location requests when the app enters background.
-        // Lifecycle observer registration must happen on the main thread.
+        // Register lifecycle observer for background cancellation and ON_APP_START.
+        // - onStop: cancels in-flight GPS requests when the app enters background.
+        // - onStart: triggers a one-shot location request on first foreground entry
+        //   when trackingMode is ON_APP_START (guaranteed foreground execution).
+        // Registration must happen on the main thread.
         val mainThreadPoster: MainThreadPoster = HandlerMainThreadPoster()
         mainThreadPoster.post {
             ProcessLifecycleOwner.get().lifecycle.addObserver(
-                LocationLifecycleObserver(services)
+                LocationLifecycleObserver(services, moduleConfig.trackingMode)
             )
         }
-
-        // ON_APP_START: auto-capture location on cold start.
-        // Routed through LocationServicesImpl so it shares the same job tracking
-        // and first-wins dedup as user-initiated requests.
-        // If permissions are denied or services disabled, orchestrator silently no-ops.
-        if (moduleConfig.trackingMode == LocationTrackingMode.ON_APP_START) {
-            services.requestLocationUpdate()
-        }
     }
 
     companion object {