expo-beacon 0.8.5 → 0.8.7

package/ios/ExpoBeaconModule+Monitoring.swift

@@ -380,4 +380,36 @@ extension ExpoBeaconModule {
             scanPromise = nil
         }
     }
+
+    /// Response to `locationManager.requestState(for:)` called during `OnCreate`
+    /// after a background process restart. When iOS confirms `.inside`, seed the
+    /// enter counter to ENTER_HYSTERESIS_COUNT − 1 so the very first valid ranging
+    /// reading immediately fires `onBeaconEnter` without accumulating additional
+    /// cycles. When `.outside`, make sure the beacon is not stuck in `enteredRegions`
+    /// from a stale prior session.
+    func handleDidDetermineState(_ state: CLRegionState, for region: CLRegion) {
+        guard let beaconRegion = region as? CLBeaconRegion else { return }
+        let identifier = beaconRegion.identifier
+        switch state {
+        case .inside:
+            // Pre-seed enter counter so the next ranging cycle completes the enter.
+            // Only set it when we have NOT already entered (avoid re-emitting enter).
+            if !enteredRegions.contains(identifier) {
+                enterCounters[identifier] = max(enterCounters[identifier] ?? 0, ENTER_HYSTERESIS_COUNT - 1)
+            }
+        case .outside:
+            // If a stale session left the beacon in entered state, clean it up.
+            if enteredRegions.remove(identifier) != nil {
+                enterCounters.removeValue(forKey: identifier)
+                exitCounters.removeValue(forKey: identifier)
+                smoothedDistances.removeValue(forKey: identifier)
+                sendLoggedEvent("onBeaconExit", makeBeaconEventParams(identifier: identifier, region: beaconRegion, event: "exit"))
+                postBeaconNotification(identifier: identifier, eventType: "exit")
+            }
+        case .unknown:
+            break
+        @unknown default:
+            break
+        }
+    }
 }

package/ios/ExpoBeaconModule.swift

@@ -150,6 +150,27 @@ public class ExpoBeaconModule: Module {
                 // to this freshly-created module learn the session ended.
                 CarPlayMonitor.shared.reconcileOnProcessStart()
             }
+            // Restart beacon ranging on process recreation (background relaunch via
+            // SLC, Visit, or region-entry wake). iOS persists CLBeaconRegion monitoring
+            // at the OS level so the app is woken on region boundary crossings, but
+            // ranging is per-process and stops when the process is terminated.
+            // Without restarting here, handleDidRange callbacks never fire until JS
+            // explicitly calls startMonitoring() — causing the observed 2-5 min
+            // detection delay when CarPlay is active and the app has been sleeping
+            // for days. ENTER_HYSTERESIS_COUNT=1, so the first valid ranging reading
+            // fires onBeaconEnter within ~1 s of ranging resuming.
+            if self.defaults.bool(forKey: IS_MONITORING_KEY) {
+                let authStatus = self.locationManager.authorizationStatus
+                if authStatus == .authorizedAlways || authStatus == .authorizedWhenInUse {
+                    self.startRegionMonitoring()
+                    // Ask iOS for immediate region-state delivery: if the device is
+                    // already inside a monitored region, didDetermineState fires with
+                    // .inside without waiting for the next organic boundary crossing.
+                    for region in self.monitoredRegions {
+                        self.locationManager.requestState(for: region)
+                    }
+                }
+            }
         }
 
         Events("onBeaconEnter", "onBeaconExit", "onBeaconDistance", "onBeaconTimeout", "onBeaconFound", "onEddystoneFound", "onEddystoneEnter", "onEddystoneExit", "onEddystoneDistance", "onEddystoneTimeout", "onBeaconError", "onCarPlayConnected", "onCarPlayDisconnected")
@@ -467,12 +488,12 @@ public class ExpoBeaconModule: Module {
             self.startCarPlayMonitoringInternal()
             promise.resolve(nil)
         }
-self.removeAppForegroundObserverForCarPlay()
-            
+
         AsyncFunction("stopCarPlayMonitoring") { (promise: Promise) in
             self.defaults.set(false, forKey: CARPLAY_MONITORING_ENABLED_KEY)
             CarPlayMonitor.shared.stop()
             self.stopCarPlayBackgroundWakes()
+            self.removeAppForegroundObserverForCarPlay()
             promise.resolve(nil)
         }
 
@@ -633,11 +654,11 @@ self.removeAppForegroundObserverForCarPlay()
             // that route changes continue to be observed across module recreations
             // (e.g. background-launch wake → module re-init → OnDestroy on suspend).
             if !self.defaults.bool(forKey: CARPLAY_MONITORING_ENABLED_KEY) {
-             
+                CarPlayMonitor.shared.stop()
+            }
             // Foreground observer is bound to this module instance — always
             // remove it on destroy to avoid leaking observers across recreations.
-            self.removeAppForegroundObserverForCarPlay()   CarPlayMonitor.shared.stop()
-            }
+            self.removeAppForegroundObserverForCarPlay()
             self.centralManager?.stopScan()
             self.centralManager = nil
             self.scanTimer?.cancel()

package/ios/LocationDelegate.swift

@@ -45,4 +45,12 @@ internal final class LocationDelegate: NSObject, CLLocationManagerDelegate {
     func locationManager(_ manager: CLLocationManager, didVisit visit: CLVisit) {
         module?.handleBackgroundWakeForCarPlay()
     }
+
+    // Response to requestState(for:) — called by iOS after a background-process
+    // restart to confirm whether the device is currently inside a monitored
+    // region. Forwarded so the module can log and take action (e.g. emit a
+    // synthetic enter if state is .inside and ranging has not yet delivered data).
+    func locationManager(_ manager: CLLocationManager, didDetermineState state: CLRegionState, for region: CLRegion) {
+        module?.handleDidDetermineState(state, for: region)
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-beacon",
-  "version": "0.8.5",
+  "version": "0.8.7",
   "description": "Expo module for scanning, pairing, and monitoring iBeacons on Android and iOS",
   "main": "build/index.js",
   "types": "build/index.d.ts",