expo-beacon 0.6.13 → 0.6.15

package/android/src/main/java/expo/modules/beacon/BeaconConstants.kt

@@ -37,6 +37,12 @@ internal const val RECENT_RANGING_SIGHTING_GRACE_MS = 25000L
  */
 internal const val EXIT_MISS_THRESHOLD = 10
 
+/**
+ * Milliseconds of no valid BLE readings before starting the timeout countdown.
+ * Acts as a safety net when ranging cycles stop entirely (e.g. Doze mode).
+ */
+internal const val DISTANCE_INACTIVITY_MS = 60_000L
+
 /** Number of consecutive readings required to confirm a distance-based enter or exit transition. */
 internal const val HYSTERESIS_COUNT = 3
 

package/android/src/main/java/expo/modules/beacon/BeaconForegroundService.kt

@@ -64,8 +64,12 @@ class BeaconForegroundService : Service(), BeaconConsumer {
     private val timeoutRunnables = java.util.concurrent.ConcurrentHashMap<String, Runnable>()
     // Per-beacon timeout seconds lookup (identifier → seconds), loaded from paired data
     private val beaconTimeouts = java.util.concurrent.ConcurrentHashMap<String, Int>()
+    // Inactivity timers — start timeout countdown when no BLE readings for 60 s
+    private val inactivityRunnables = java.util.concurrent.ConcurrentHashMap<String, Runnable>()
     private var eventLogger: BeaconEventLogger? = null
     private var apiForwarder: BeaconApiForwarder? = null
+    // Event level: "all" emits distance + enter/exit/timeout; "events" suppresses distance.
+    @Volatile private var eventLevel: String = "all"
 
     override fun onCreate() {
         super.onCreate()
@@ -125,6 +129,7 @@ class BeaconForegroundService : Service(), BeaconConsumer {
         maxDistance = optPrefs.getString("max_distance", null)?.toDoubleOrNull()
         exitDistance = optPrefs.getString("exit_distance", null)?.toDoubleOrNull()
         minRssiThreshold = optPrefs.getInt("min_rssi", DEFAULT_MIN_RSSI)
+        eventLevel = optPrefs.getString("level", "all") ?: "all"
 
         beaconManager.addMonitorNotifier(monitorNotifier)
         beaconManager.addRangeNotifier(rangeNotifier)
@@ -174,6 +179,7 @@ class BeaconForegroundService : Service(), BeaconConsumer {
         lastSeenAtMs.clear()
         timeoutHandler.removeCallbacksAndMessages(null)
         timeoutRunnables.clear()
+        inactivityRunnables.clear()
         synchronized(distanceLock) {
             enterCounters.clear()
             exitCounters.clear()
@@ -256,10 +262,13 @@ class BeaconForegroundService : Service(), BeaconConsumer {
 
     // Distance logging only — emits distance broadcasts. Enter/exit logic lives in rangeNotifier.
     private val distanceLoggingRangeNotifier = RangeNotifier { beacons, region ->
+        if (eventLevel != "all") return@RangeNotifier
         if (!monitoredRegionIds.contains(region.uniqueId)) return@RangeNotifier
         val closest = beacons.filter { it.distance >= 0 && it.rssi >= minRssiThreshold }.minByOrNull { it.distance }
         if (closest != null) {
             lastSeenAtMs[region.uniqueId] = SystemClock.elapsedRealtime()
+            // Valid BLE reading — reset inactivity timer.
+            rescheduleInactivity(region)
             sendBeaconBroadcast(region, "distance", closest.distance, closest.rssi)
         }
     }
@@ -290,7 +299,8 @@ class BeaconForegroundService : Service(), BeaconConsumer {
             if (wasEntered) {
                 sendBeaconBroadcast(region, "exit", -1.0)
                 showEnterExitNotification(region, "exit")
-                // OS-level exit safety net — start the timeout clock.
+                // OS-level exit safety net — cancel inactivity timer and start the timeout clock.
+                cancelInactivity(region.uniqueId)
                 scheduleTimeoutIfConfigured(region)
             }
         }
@@ -316,13 +326,11 @@ class BeaconForegroundService : Service(), BeaconConsumer {
                 // Got a valid reading — reset miss counter
                 lastSeenAtMs[region.uniqueId] = SystemClock.elapsedRealtime()
                 missCounters[region.uniqueId] = 0
+                // Valid BLE reading — reset inactivity timer.
+                rescheduleInactivity(region)
 
-                // Apply EMA smoothing; jump guard returns null for outliers
+                // Apply EMA smoothing; jump resets EMA to the new value
                 val smoothed = smoothDistance(region.uniqueId, beacon.distance)
-                if (smoothed == null) {
-                    // Outlier — treat as miss without resetting enter counter
-                    return@RangeNotifier
-                }
 
                 val action = evaluateDistanceHysteresis(region.uniqueId, smoothed, maxDist)
                 when (action) {
@@ -337,7 +345,8 @@ class BeaconForegroundService : Service(), BeaconConsumer {
                         enteredRegions.remove(region.uniqueId)
                         sendBeaconBroadcast(region, "exit", beacon.distance, beacon.rssi)
                         showEnterExitNotification(region, "exit")
-                        // Beacon left — start the timeout clock.
+                        // Beacon left — cancel inactivity timer and start the timeout clock.
+                        cancelInactivity(region.uniqueId)
                         scheduleTimeoutIfConfigured(region)
                     }
                     HysteresisAction.NONE -> {}
@@ -357,7 +366,8 @@ class BeaconForegroundService : Service(), BeaconConsumer {
                     exitCounters[region.uniqueId] = 0
                     sendBeaconBroadcast(region, "exit", -1.0)
                     showEnterExitNotification(region, "exit")
-                    // Beacon disappeared — start the timeout clock.
+                    // Beacon disappeared — cancel inactivity timer and start the timeout clock.
+                    cancelInactivity(region.uniqueId)
                     scheduleTimeoutIfConfigured(region)
                 }
             }
@@ -370,18 +380,23 @@ class BeaconForegroundService : Service(), BeaconConsumer {
 
     /**
      * Apply exponential moving average (EMA) smoothing to a raw distance reading.
-     * Returns null if the reading is a jump outlier (raw differs from smoothed by > DISTANCE_JUMP_FACTOR).
+     * If the reading is a large jump (> DISTANCE_JUMP_FACTOR), resets the EMA to the new
+     * value instead of rejecting it — this ensures the hysteresis pipeline keeps receiving
+     * data and can fire exit events when the user moves away from a beacon, rather than
+     * freezing because the EMA is stuck at the old close-range value.
      */
-    private fun smoothDistance(regionId: String, rawDistance: Double): Double? {
+    private fun smoothDistance(regionId: String, rawDistance: Double): Double {
         val prev = smoothedDistances[regionId]
         if (prev == null) {
             smoothedDistances[regionId] = rawDistance
             return rawDistance
         }
-        // Jump guard: if the raw value is wildly different, treat as outlier
+        // Jump guard: if the raw value is wildly different, reset EMA to the new reading
+        // so the hysteresis pipeline keeps receiving data and can fire the exit event.
         val ratio = if (prev > 0.001) rawDistance / prev else rawDistance
         if (ratio > DISTANCE_JUMP_FACTOR || (ratio > 0 && ratio < 1.0 / DISTANCE_JUMP_FACTOR)) {
-            return null
+            smoothedDistances[regionId] = rawDistance
+            return rawDistance
         }
         val smoothed = DISTANCE_EMA_ALPHA * rawDistance + (1 - DISTANCE_EMA_ALPHA) * prev
         smoothedDistances[regionId] = smoothed
@@ -472,6 +487,25 @@ class BeaconForegroundService : Service(), BeaconConsumer {
         timeoutRunnables.remove(regionId)?.let { timeoutHandler.removeCallbacks(it) }
     }
 
+    // MARK: - Inactivity timer helpers (no BLE readings → start timeout countdown)
+
+    private fun rescheduleInactivity(region: Region) {
+        val regionId = region.uniqueId
+        if (!beaconTimeouts.containsKey(regionId)) return
+        cancelInactivity(regionId)
+        val runnable = Runnable {
+            inactivityRunnables.remove(regionId)
+            // No BLE readings for 60 s — start the configured timeout countdown.
+            scheduleTimeoutIfConfigured(region)
+        }
+        inactivityRunnables[regionId] = runnable
+        timeoutHandler.postDelayed(runnable, DISTANCE_INACTIVITY_MS)
+    }
+
+    private fun cancelInactivity(regionId: String) {
+        inactivityRunnables.remove(regionId)?.let { timeoutHandler.removeCallbacks(it) }
+    }
+
     private fun sendBeaconBroadcast(region: Region, eventType: String, distance: Double, rssi: Int = 0) {
         // Determine if this is an Eddystone region based on identifier format
         // Eddystone regions have id1 as a hex namespace (not a UUID)
@@ -500,10 +534,8 @@ class BeaconForegroundService : Service(), BeaconConsumer {
         }
         monitoringEventName(isEddystone, eventType)?.let { logBeaconEvent(it, params) }
 
-        // Forward enter/exit/timeout events to remote API (skip distance — too frequent)
-        if (eventType != "distance") {
-            apiForwarder?.forwardEvent(params)
-        }
+        // Forward all produced events to remote API
+        apiForwarder?.forwardEvent(params)
 
         val intent = Intent(ACTION_BEACON_EVENT).apply {
             putExtra("identifier", region.uniqueId)
@@ -733,6 +765,7 @@ class BeaconForegroundService : Service(), BeaconConsumer {
         serviceConnected = false
         timeoutHandler.removeCallbacksAndMessages(null)
         timeoutRunnables.clear()
+        inactivityRunnables.clear()
         beaconTimeouts.clear()
         lastSeenAtMs.clear()
         monitoredRegionIds.clear()

package/android/src/main/java/expo/modules/beacon/ExpoBeaconModule.kt

@@ -282,6 +282,7 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
             var maxDistance: Double? = null
             var exitDistance: Double? = null
             var minRssi: Int? = null
+            var level: String = "all"
             when (options) {
                 is Double -> maxDistance = options
                 is Map<*, *> -> {
@@ -290,6 +291,7 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
                     maxDistance = (map["maxDistance"] as? Number)?.toDouble()
                     exitDistance = (map["exitDistance"] as? Number)?.toDouble()
                     minRssi = (map["minRssi"] as? Number)?.toInt()
+                    level = (map["level"] as? String) ?: "all"
                     val notifications = map["notifications"]
                     if (notifications is Map<*, *>) {
                         @Suppress("UNCHECKED_CAST")
@@ -322,6 +324,7 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
                     else remove("exit_distance")
                     if (minRssi != null) putInt("min_rssi", minRssi)
                     else remove("min_rssi")
+                    putString("level", level)
                 }.apply()
             // Verify we have the permissions needed for background monitoring
             val hasLocation = ContextCompat.checkSelfPermission(ctx, Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED

package/build/ExpoBeacon.types.d.ts

@@ -26,6 +26,9 @@ export type PairedBeacon = {
      * Timeout in seconds. When set, the module fires `onBeaconTimeout` once
      * after the beacon has been continuously in range for this duration.
      * The timer resets if the beacon exits and re-enters range.
+     *
+     * The timeout countdown also starts if no BLE readings are received
+     * for 60 seconds (e.g. due to Doze mode or background throttling).
      */
     timeoutSeconds?: number;
 };
@@ -132,6 +135,13 @@ export type MonitoringOptions = {
      * Default: -85. Typical range: -100 (very permissive) to -70 (strict).
      */
     minRssi?: number;
+    /**
+     * Controls which event types are emitted, logged, and forwarded to the API.
+     *
+     * - `'all'` (default): distance + enter + exit + timeout events.
+     * - `'events'`: enter + exit + timeout only (no distance events).
+     */
+    level?: 'all' | 'events';
     /** Notification configuration overrides to apply for this monitoring session. */
     notifications?: NotificationConfig;
 };
@@ -170,6 +180,9 @@ export type PairedEddystone = {
      * Timeout in seconds. When set, the module fires `onEddystoneTimeout` once
      * after the beacon has been continuously in range for this duration.
      * The timer resets if the beacon exits and re-enters range.
+     *
+     * The timeout countdown also starts if no BLE readings are received
+     * for 60 seconds (e.g. due to Doze mode or background throttling).
      */
     timeoutSeconds?: number;
 };

package/build/ExpoBeacon.types.d.ts.map

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

package/build/ExpoBeacon.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoBeacon.types.js","sourceRoot":"","sources":["../src/ExpoBeacon.types.ts"],"names":[],"mappings":"","sourcesContent":["/** Raw beacon discovered during a scan. */\r\nexport type BeaconScanResult = {\r\n  uuid: string; // iBeacon proximity UUID (uppercase, formatted)\r\n  major: number; // iBeacon major value (0–65535)\r\n  minor: number; // iBeacon minor value (0–65535)\r\n  rssi: number; // Signal strength in dBm (negative number)\r\n  distance: number; // Estimated distance in meters\r\n  txPower: number; // Calibrated TX power\r\n  /** BLE advertising device name. May be undefined on iOS (CoreLocation does not expose it for iBeacon). */\r\n  name?: string;\r\n};\r\n\r\n/**\r\n * A beacon that has been paired/registered for monitoring.\r\n *\r\n * Note: Paired beacon data is stored unencrypted in UserDefaults (iOS) /\r\n * SharedPreferences (Android) and may be included in device backups.\r\n */\r\nexport type PairedBeacon = {\r\n  identifier: string; // User-defined label (e.g. \"lobby-door\")\r\n  uuid: string;\r\n  major: number;\r\n  minor: number;\r\n  /** BLE advertising device name, if provided at pairing time. */\r\n  name?: string;\r\n  /**\r\n   * Timeout in seconds. When set, the module fires `onBeaconTimeout` once\r\n   * after the beacon has been continuously in range for this duration.\r\n   * The timer resets if the beacon exits and re-enters range.\r\n   */\r\n  timeoutSeconds?: number;\r\n};\r\n\r\n/** Payload for enter/exit region events. */\r\nexport type BeaconRegionEvent = {\r\n  identifier: string; // Matches PairedBeacon.identifier\r\n  uuid: string;\r\n  major: number;\r\n  minor: number;\r\n  event: \"enter\" | \"exit\";\r\n  /** Measured distance in metres at the time of the event (–1 if unavailable). */\r\n  distance: number;\r\n  /** Signal strength in dBm at the time of the event (0 if unavailable). */\r\n  rssi?: number;\r\n};\r\n\r\n/** Payload for periodic distance update events during monitoring. */\r\nexport type BeaconDistanceEvent = {\r\n  identifier: string;\r\n  uuid: string;\r\n  major: number;\r\n  minor: number;\r\n  distance: number;\r\n  /** Signal strength in dBm (0 if unavailable). */\r\n  rssi?: number;\r\n};\r\n\r\n/** Payload for beacon timeout events (beacon in range for configured duration). */\r\nexport type BeaconTimeoutEvent = {\r\n  identifier: string;\r\n  uuid: string;\r\n  major: number;\r\n  minor: number;\r\n  /** Current distance in metres at the time the timeout fired. */\r\n  distance: number;\r\n};\r\n\r\n/** Configuration for beacon enter/exit event notifications. */\r\nexport type BeaconNotificationConfig = {\r\n  /** Whether to show enter/exit notifications. Default: true. */\r\n  enabled?: boolean;\r\n  /** Notification title on beacon enter. Default: \"Beacon Entered\". */\r\n  enterTitle?: string;\r\n  /** Notification title on beacon exit. Default: \"Beacon Exited\". */\r\n  exitTitle?: string;\r\n  /**\r\n   * Notification body template. Supports {identifier} and {event} placeholders.\r\n   * Default: \"{identifier} region {event}ed\".\r\n   */\r\n  body?: string;\r\n  /** Play a sound with the notification (iOS only). Default: true. */\r\n  sound?: boolean;\r\n  /** Android drawable resource name for the notification icon (e.g. \"ic_notification\"). */\r\n  icon?: string;\r\n};\r\n\r\n/** Configuration for the Android foreground service notification (persistent status bar entry). */\r\nexport type ForegroundServiceConfig = {\r\n  /** Title of the persistent notification. Default: \"Beacon Monitoring Active\". */\r\n  title?: string;\r\n  /** Body text of the persistent notification. Default: \"Monitoring for iBeacons in the background\". */\r\n  text?: string;\r\n  /** Android drawable resource name for the notification icon. */\r\n  icon?: string;\r\n};\r\n\r\n/** Configuration for the Android notification channel. */\r\nexport type NotificationChannelConfig = {\r\n  /** Channel display name shown in system settings. Default: \"Beacon Monitoring\". */\r\n  name?: string;\r\n  /** Channel description shown in system settings. Default: \"Used for background iBeacon region monitoring\". */\r\n  description?: string;\r\n  /**\r\n   * Channel importance level. Default: 'low'.\r\n   * Note: Android may ignore decreases in importance after first channel creation until the app is reinstalled.\r\n   */\r\n  importance?: \"low\" | \"default\" | \"high\";\r\n};\r\n\r\n/** Combined notification configuration for all notification types. */\r\nexport type NotificationConfig = {\r\n  /** Settings for beacon enter/exit event notifications. */\r\n  beaconEvents?: BeaconNotificationConfig;\r\n  /** Settings for the persistent foreground service notification (Android only). */\r\n  foregroundService?: ForegroundServiceConfig;\r\n  /** Settings for the Android notification channel (Android only). */\r\n  channel?: NotificationChannelConfig;\r\n};\r\n\r\n/** Options accepted by startMonitoring(). */\r\nexport type MonitoringOptions = {\r\n  /**\r\n   * Maximum distance in metres for distance-based enter events.\r\n   * Exit events are always emitted when the region is lost.\r\n   */\r\n  maxDistance?: number;\r\n  /**\r\n   * Distance in metres at which exit events fire (must be ≥ maxDistance).\r\n   * Creates a hysteresis band between enter and exit thresholds to prevent\r\n   * rapid toggling near the boundary.\r\n   *\r\n   * Default when omitted: `maxDistance + min(maxDistance × 0.5, 2.5)`.\r\n   * Only used when `maxDistance` is set.\r\n   */\r\n  exitDistance?: number;\r\n  /**\r\n   * Minimum RSSI (dBm) for a beacon reading to be considered valid.\r\n   * Readings below this threshold are discarded as unreliable, preventing\r\n   * false detections from reflected or distant signals.\r\n   *\r\n   * Default: -85. Typical range: -100 (very permissive) to -70 (strict).\r\n   */\r\n  minRssi?: number;\r\n  /** Notification configuration overrides to apply for this monitoring session. */\r\n  notifications?: NotificationConfig;\r\n};\r\n\r\n/** Eddystone frame type. */\r\nexport type EddystoneFrameType = \"uid\" | \"url\";\r\n\r\n/** Raw Eddystone beacon discovered during a scan. */\r\nexport type EddystoneScanResult = {\r\n  frameType: EddystoneFrameType;\r\n  /** 10-byte namespace ID as hex string (20 chars). Present for UID frames. */\r\n  namespace?: string;\r\n  /** 6-byte instance ID as hex string (12 chars). Present for UID frames. */\r\n  instance?: string;\r\n  /** Decoded URL. Present for URL frames. */\r\n  url?: string;\r\n  rssi: number;\r\n  distance: number;\r\n  txPower: number;\r\n  /** BLE advertising device name. */\r\n  name?: string;\r\n};\r\n\r\n/**\r\n * An Eddystone-UID beacon that has been paired/registered for monitoring.\r\n *\r\n * Note: Paired beacon data is stored unencrypted in UserDefaults (iOS) /\r\n * SharedPreferences (Android) and may be included in device backups.\r\n */\r\nexport type PairedEddystone = {\r\n  identifier: string;\r\n  /** 10-byte namespace ID as hex string (20 chars). */\r\n  namespace: string;\r\n  /** 6-byte instance ID as hex string (12 chars). */\r\n  instance: string;\r\n  /** BLE advertising device name, if provided at pairing time. */\r\n  name?: string;\r\n  /**\r\n   * Timeout in seconds. When set, the module fires `onEddystoneTimeout` once\r\n   * after the beacon has been continuously in range for this duration.\r\n   * The timer resets if the beacon exits and re-enters range.\r\n   */\r\n  timeoutSeconds?: number;\r\n};\r\n\r\n/** Payload for Eddystone enter/exit region events. */\r\nexport type EddystoneRegionEvent = {\r\n  identifier: string;\r\n  namespace: string;\r\n  instance: string;\r\n  event: \"enter\" | \"exit\";\r\n  /** Measured distance in metres at the time of the event (–1 if unavailable). */\r\n  distance: number;\r\n  /** Signal strength in dBm at the time of the event (0 if unavailable). */\r\n  rssi?: number;\r\n};\r\n\r\n/** Payload for periodic Eddystone distance update events during monitoring. */\r\nexport type EddystoneDistanceEvent = {\r\n  identifier: string;\r\n  namespace: string;\r\n  instance: string;\r\n  distance: number;\r\n  /** Signal strength in dBm (0 if unavailable). */\r\n  rssi?: number;\r\n};\r\n\r\n/** Payload for Eddystone timeout events (beacon in range for configured duration). */\r\nexport type EddystoneTimeoutEvent = {\r\n  identifier: string;\r\n  namespace: string;\r\n  instance: string;\r\n  /** Current distance in metres at the time the timeout fired. */\r\n  distance: number;\r\n};\r\n\r\n/** Module event map. */\r\nexport type ExpoBeaconModuleEvents = {\r\n  onBeaconEnter: (params: BeaconRegionEvent) => void;\r\n  onBeaconExit: (params: BeaconRegionEvent) => void;\r\n  onBeaconDistance: (params: BeaconDistanceEvent) => void;\r\n  /** Fired once after a paired beacon has been continuously in range for its configured `timeoutSeconds`. */\r\n  onBeaconTimeout: (params: BeaconTimeoutEvent) => void;\r\n  /** Fired continuously during a live scan as each iBeacon is detected. */\r\n  onBeaconFound: (params: BeaconScanResult) => void;\r\n  /** Fired continuously during a live scan as each Eddystone beacon is detected. */\r\n  onEddystoneFound: (params: EddystoneScanResult) => void;\r\n  onEddystoneEnter: (params: EddystoneRegionEvent) => void;\r\n  onEddystoneExit: (params: EddystoneRegionEvent) => void;\r\n  onEddystoneDistance: (params: EddystoneDistanceEvent) => void;\r\n  /** Fired once after a paired Eddystone has been continuously in range for its configured `timeoutSeconds`. */\r\n  onEddystoneTimeout: (params: EddystoneTimeoutEvent) => void;\r\n};\r\n\r\n/** Options for filtering event logs. */\r\nexport type EventLogQueryOptions = {\r\n  /** Maximum number of log entries to return (default: 1000, max: 10000). */\r\n  limit?: number;\r\n  /** Filter by event type (e.g. \"onBeaconEnter\", \"onBeaconExit\"). */\r\n  eventType?: string;\r\n  /** Only return events with timestamp >= this value (ms since epoch). */\r\n  sinceTimestamp?: number;\r\n};\r\n\r\n/** A single logged beacon event entry. */\r\nexport type EventLogEntry = {\r\n  id: number;\r\n  /** Timestamp in milliseconds since epoch. */\r\n  timestamp: number;\r\n  /** The event type that was logged (e.g. \"onBeaconEnter\"). */\r\n  eventType: string;\r\n  /** Beacon identifier, if available. */\r\n  identifier?: string;\r\n  /** The full event payload that was sent to JS. */\r\n  data: Record<string, unknown>;\r\n};\r\n"]}
+{"version":3,"file":"ExpoBeacon.types.js","sourceRoot":"","sources":["../src/ExpoBeacon.types.ts"],"names":[],"mappings":"","sourcesContent":["/** Raw beacon discovered during a scan. */\r\nexport type BeaconScanResult = {\r\n  uuid: string; // iBeacon proximity UUID (uppercase, formatted)\r\n  major: number; // iBeacon major value (0–65535)\r\n  minor: number; // iBeacon minor value (0–65535)\r\n  rssi: number; // Signal strength in dBm (negative number)\r\n  distance: number; // Estimated distance in meters\r\n  txPower: number; // Calibrated TX power\r\n  /** BLE advertising device name. May be undefined on iOS (CoreLocation does not expose it for iBeacon). */\r\n  name?: string;\r\n};\r\n\r\n/**\r\n * A beacon that has been paired/registered for monitoring.\r\n *\r\n * Note: Paired beacon data is stored unencrypted in UserDefaults (iOS) /\r\n * SharedPreferences (Android) and may be included in device backups.\r\n */\r\nexport type PairedBeacon = {\r\n  identifier: string; // User-defined label (e.g. \"lobby-door\")\r\n  uuid: string;\r\n  major: number;\r\n  minor: number;\r\n  /** BLE advertising device name, if provided at pairing time. */\r\n  name?: string;\r\n  /**\r\n   * Timeout in seconds. When set, the module fires `onBeaconTimeout` once\r\n   * after the beacon has been continuously in range for this duration.\r\n   * The timer resets if the beacon exits and re-enters range.\r\n   *\r\n   * The timeout countdown also starts if no BLE readings are received\r\n   * for 60 seconds (e.g. due to Doze mode or background throttling).\r\n   */\r\n  timeoutSeconds?: number;\r\n};\r\n\r\n/** Payload for enter/exit region events. */\r\nexport type BeaconRegionEvent = {\r\n  identifier: string; // Matches PairedBeacon.identifier\r\n  uuid: string;\r\n  major: number;\r\n  minor: number;\r\n  event: \"enter\" | \"exit\";\r\n  /** Measured distance in metres at the time of the event (–1 if unavailable). */\r\n  distance: number;\r\n  /** Signal strength in dBm at the time of the event (0 if unavailable). */\r\n  rssi?: number;\r\n};\r\n\r\n/** Payload for periodic distance update events during monitoring. */\r\nexport type BeaconDistanceEvent = {\r\n  identifier: string;\r\n  uuid: string;\r\n  major: number;\r\n  minor: number;\r\n  distance: number;\r\n  /** Signal strength in dBm (0 if unavailable). */\r\n  rssi?: number;\r\n};\r\n\r\n/** Payload for beacon timeout events (beacon in range for configured duration). */\r\nexport type BeaconTimeoutEvent = {\r\n  identifier: string;\r\n  uuid: string;\r\n  major: number;\r\n  minor: number;\r\n  /** Current distance in metres at the time the timeout fired. */\r\n  distance: number;\r\n};\r\n\r\n/** Configuration for beacon enter/exit event notifications. */\r\nexport type BeaconNotificationConfig = {\r\n  /** Whether to show enter/exit notifications. Default: true. */\r\n  enabled?: boolean;\r\n  /** Notification title on beacon enter. Default: \"Beacon Entered\". */\r\n  enterTitle?: string;\r\n  /** Notification title on beacon exit. Default: \"Beacon Exited\". */\r\n  exitTitle?: string;\r\n  /**\r\n   * Notification body template. Supports {identifier} and {event} placeholders.\r\n   * Default: \"{identifier} region {event}ed\".\r\n   */\r\n  body?: string;\r\n  /** Play a sound with the notification (iOS only). Default: true. */\r\n  sound?: boolean;\r\n  /** Android drawable resource name for the notification icon (e.g. \"ic_notification\"). */\r\n  icon?: string;\r\n};\r\n\r\n/** Configuration for the Android foreground service notification (persistent status bar entry). */\r\nexport type ForegroundServiceConfig = {\r\n  /** Title of the persistent notification. Default: \"Beacon Monitoring Active\". */\r\n  title?: string;\r\n  /** Body text of the persistent notification. Default: \"Monitoring for iBeacons in the background\". */\r\n  text?: string;\r\n  /** Android drawable resource name for the notification icon. */\r\n  icon?: string;\r\n};\r\n\r\n/** Configuration for the Android notification channel. */\r\nexport type NotificationChannelConfig = {\r\n  /** Channel display name shown in system settings. Default: \"Beacon Monitoring\". */\r\n  name?: string;\r\n  /** Channel description shown in system settings. Default: \"Used for background iBeacon region monitoring\". */\r\n  description?: string;\r\n  /**\r\n   * Channel importance level. Default: 'low'.\r\n   * Note: Android may ignore decreases in importance after first channel creation until the app is reinstalled.\r\n   */\r\n  importance?: \"low\" | \"default\" | \"high\";\r\n};\r\n\r\n/** Combined notification configuration for all notification types. */\r\nexport type NotificationConfig = {\r\n  /** Settings for beacon enter/exit event notifications. */\r\n  beaconEvents?: BeaconNotificationConfig;\r\n  /** Settings for the persistent foreground service notification (Android only). */\r\n  foregroundService?: ForegroundServiceConfig;\r\n  /** Settings for the Android notification channel (Android only). */\r\n  channel?: NotificationChannelConfig;\r\n};\r\n\r\n/** Options accepted by startMonitoring(). */\r\nexport type MonitoringOptions = {\r\n  /**\r\n   * Maximum distance in metres for distance-based enter events.\r\n   * Exit events are always emitted when the region is lost.\r\n   */\r\n  maxDistance?: number;\r\n  /**\r\n   * Distance in metres at which exit events fire (must be ≥ maxDistance).\r\n   * Creates a hysteresis band between enter and exit thresholds to prevent\r\n   * rapid toggling near the boundary.\r\n   *\r\n   * Default when omitted: `maxDistance + min(maxDistance × 0.5, 2.5)`.\r\n   * Only used when `maxDistance` is set.\r\n   */\r\n  exitDistance?: number;\r\n  /**\r\n   * Minimum RSSI (dBm) for a beacon reading to be considered valid.\r\n   * Readings below this threshold are discarded as unreliable, preventing\r\n   * false detections from reflected or distant signals.\r\n   *\r\n   * Default: -85. Typical range: -100 (very permissive) to -70 (strict).\r\n   */\r\n  minRssi?: number;\r\n  /**\r\n   * Controls which event types are emitted, logged, and forwarded to the API.\r\n   *\r\n   * - `'all'` (default): distance + enter + exit + timeout events.\r\n   * - `'events'`: enter + exit + timeout only (no distance events).\r\n   */\r\n  level?: 'all' | 'events';\r\n  /** Notification configuration overrides to apply for this monitoring session. */\r\n  notifications?: NotificationConfig;\r\n};\r\n\r\n/** Eddystone frame type. */\r\nexport type EddystoneFrameType = \"uid\" | \"url\";\r\n\r\n/** Raw Eddystone beacon discovered during a scan. */\r\nexport type EddystoneScanResult = {\r\n  frameType: EddystoneFrameType;\r\n  /** 10-byte namespace ID as hex string (20 chars). Present for UID frames. */\r\n  namespace?: string;\r\n  /** 6-byte instance ID as hex string (12 chars). Present for UID frames. */\r\n  instance?: string;\r\n  /** Decoded URL. Present for URL frames. */\r\n  url?: string;\r\n  rssi: number;\r\n  distance: number;\r\n  txPower: number;\r\n  /** BLE advertising device name. */\r\n  name?: string;\r\n};\r\n\r\n/**\r\n * An Eddystone-UID beacon that has been paired/registered for monitoring.\r\n *\r\n * Note: Paired beacon data is stored unencrypted in UserDefaults (iOS) /\r\n * SharedPreferences (Android) and may be included in device backups.\r\n */\r\nexport type PairedEddystone = {\r\n  identifier: string;\r\n  /** 10-byte namespace ID as hex string (20 chars). */\r\n  namespace: string;\r\n  /** 6-byte instance ID as hex string (12 chars). */\r\n  instance: string;\r\n  /** BLE advertising device name, if provided at pairing time. */\r\n  name?: string;\r\n  /**\r\n   * Timeout in seconds. When set, the module fires `onEddystoneTimeout` once\r\n   * after the beacon has been continuously in range for this duration.\r\n   * The timer resets if the beacon exits and re-enters range.\r\n   *\r\n   * The timeout countdown also starts if no BLE readings are received\r\n   * for 60 seconds (e.g. due to Doze mode or background throttling).\r\n   */\r\n  timeoutSeconds?: number;\r\n};\r\n\r\n/** Payload for Eddystone enter/exit region events. */\r\nexport type EddystoneRegionEvent = {\r\n  identifier: string;\r\n  namespace: string;\r\n  instance: string;\r\n  event: \"enter\" | \"exit\";\r\n  /** Measured distance in metres at the time of the event (–1 if unavailable). */\r\n  distance: number;\r\n  /** Signal strength in dBm at the time of the event (0 if unavailable). */\r\n  rssi?: number;\r\n};\r\n\r\n/** Payload for periodic Eddystone distance update events during monitoring. */\r\nexport type EddystoneDistanceEvent = {\r\n  identifier: string;\r\n  namespace: string;\r\n  instance: string;\r\n  distance: number;\r\n  /** Signal strength in dBm (0 if unavailable). */\r\n  rssi?: number;\r\n};\r\n\r\n/** Payload for Eddystone timeout events (beacon in range for configured duration). */\r\nexport type EddystoneTimeoutEvent = {\r\n  identifier: string;\r\n  namespace: string;\r\n  instance: string;\r\n  /** Current distance in metres at the time the timeout fired. */\r\n  distance: number;\r\n};\r\n\r\n/** Module event map. */\r\nexport type ExpoBeaconModuleEvents = {\r\n  onBeaconEnter: (params: BeaconRegionEvent) => void;\r\n  onBeaconExit: (params: BeaconRegionEvent) => void;\r\n  onBeaconDistance: (params: BeaconDistanceEvent) => void;\r\n  /** Fired once after a paired beacon has been continuously in range for its configured `timeoutSeconds`. */\r\n  onBeaconTimeout: (params: BeaconTimeoutEvent) => void;\r\n  /** Fired continuously during a live scan as each iBeacon is detected. */\r\n  onBeaconFound: (params: BeaconScanResult) => void;\r\n  /** Fired continuously during a live scan as each Eddystone beacon is detected. */\r\n  onEddystoneFound: (params: EddystoneScanResult) => void;\r\n  onEddystoneEnter: (params: EddystoneRegionEvent) => void;\r\n  onEddystoneExit: (params: EddystoneRegionEvent) => void;\r\n  onEddystoneDistance: (params: EddystoneDistanceEvent) => void;\r\n  /** Fired once after a paired Eddystone has been continuously in range for its configured `timeoutSeconds`. */\r\n  onEddystoneTimeout: (params: EddystoneTimeoutEvent) => void;\r\n};\r\n\r\n/** Options for filtering event logs. */\r\nexport type EventLogQueryOptions = {\r\n  /** Maximum number of log entries to return (default: 1000, max: 10000). */\r\n  limit?: number;\r\n  /** Filter by event type (e.g. \"onBeaconEnter\", \"onBeaconExit\"). */\r\n  eventType?: string;\r\n  /** Only return events with timestamp >= this value (ms since epoch). */\r\n  sinceTimestamp?: number;\r\n};\r\n\r\n/** A single logged beacon event entry. */\r\nexport type EventLogEntry = {\r\n  id: number;\r\n  /** Timestamp in milliseconds since epoch. */\r\n  timestamp: number;\r\n  /** The event type that was logged (e.g. \"onBeaconEnter\"). */\r\n  eventType: string;\r\n  /** Beacon identifier, if available. */\r\n  identifier?: string;\r\n  /** The full event payload that was sent to JS. */\r\n  data: Record<string, unknown>;\r\n};\r\n"]}

package/build/ExpoBeaconModule.d.ts

@@ -104,7 +104,7 @@ declare class ExpoBeaconModule extends NativeModule<ExpoBeaconModuleEvents> {
     destroyEventLogs(): void;
     /**
      * Configure a remote API endpoint for native event forwarding.
-     * Once set, enter/exit/timeout events are POSTed directly from native code,
+     * Once set, beacon events are POSTed directly from native code,
      * ensuring delivery even when the JS bridge is not active (app backgrounded).
      *
      * @param url The API endpoint URL to POST events to.

package/build/ExpoBeaconModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoBeaconModule.js","sourceRoot":"","sources":["../src/ExpoBeaconModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAuKzD,eAAe,mBAAmB,CAAmB,YAAY,CAAC,CAAC","sourcesContent":["import { NativeModule, requireNativeModule } from \"expo\";\r\n\r\nimport {\r\n  ExpoBeaconModuleEvents,\r\n  BeaconScanResult,\r\n  EddystoneScanResult,\r\n  PairedBeacon,\r\n  PairedEddystone,\r\n  NotificationConfig,\r\n  MonitoringOptions,\r\n  EventLogQueryOptions,\r\n  EventLogEntry,\r\n} from \"./ExpoBeacon.types\";\r\n\r\ndeclare class ExpoBeaconModule extends NativeModule<ExpoBeaconModuleEvents> {\r\n  /**\r\n   * Start a one-shot iBeacon scan. Resolves with discovered beacons after scanDuration ms.\r\n   *\r\n   * Pass one or more UUIDs to scan for specific beacons (uses CoreLocation on iOS).\r\n   * On iOS, at least one UUID is required — Apple strips iBeacon data from BLE\r\n   * advertisements, making wildcard discovery impossible. When you pass an empty\r\n   * array, the module automatically uses UUIDs from paired beacons.\r\n   * On Android, pass an empty array to discover all nearby iBeacons.\r\n   *\r\n   * @param uuids Proximity UUIDs to filter by. Empty/omitted = use paired UUIDs (iOS) or wildcard (Android).\r\n   * @param scanDuration Duration in ms (default 5000)\r\n   */\r\n  scanForBeaconsAsync(\r\n    uuids?: string[],\r\n    scanDuration?: number,\r\n  ): Promise<BeaconScanResult[]>;\r\n\r\n  /**\r\n   * Start a one-shot Eddystone beacon scan using BLE.\r\n   * Discovers Eddystone-UID and Eddystone-URL frames.\r\n   *\r\n   * @param scanDuration Duration in ms (default 5000)\r\n   */\r\n  scanForEddystonesAsync(\r\n    scanDuration?: number,\r\n  ): Promise<EddystoneScanResult[]>;\r\n\r\n  /**\r\n   * Register a beacon for persistent region monitoring.\r\n   */\r\n  pairBeacon(\r\n    identifier: string,\r\n    uuid: string,\r\n    major: number,\r\n    minor: number,\r\n    name?: string,\r\n    timeoutSeconds?: number,\r\n  ): void;\r\n\r\n  /**\r\n   * Remove a previously paired beacon.\r\n   */\r\n  unpairBeacon(identifier: string): void;\r\n\r\n  /**\r\n   * Return all currently paired beacons.\r\n   */\r\n  getPairedBeacons(): PairedBeacon[];\r\n\r\n  /**\r\n   * Register an Eddystone-UID beacon for persistent monitoring.\r\n   */\r\n  pairEddystone(\r\n    identifier: string,\r\n    namespace: string,\r\n    instance: string,\r\n    name?: string,\r\n    timeoutSeconds?: number,\r\n  ): void;\r\n\r\n  /**\r\n   * Remove a previously paired Eddystone beacon.\r\n   */\r\n  unpairEddystone(identifier: string): void;\r\n\r\n  /**\r\n   * Return all currently paired Eddystone beacons.\r\n   */\r\n  getPairedEddystones(): PairedEddystone[];\r\n\r\n  /**\r\n   * Set persistent notification configuration. Settings are saved and applied to all\r\n   * subsequent monitoring sessions until explicitly changed.\r\n   */\r\n  setNotificationConfig(config: NotificationConfig): void;\r\n\r\n  /**\r\n   * Start background region monitoring for all paired beacons.\r\n   * On Android starts a foreground service.\r\n   * On iOS starts CLLocationManager region monitoring.\r\n   *\r\n   * Accepts a plain number (backward-compatible maxDistance shorthand) or a\r\n   * MonitoringOptions object with maxDistance and/or notification overrides.\r\n   */\r\n  startMonitoring(options?: MonitoringOptions | number): Promise<void>;\r\n\r\n  /**\r\n   * Stop background region monitoring.\r\n   */\r\n  stopMonitoring(): Promise<void>;\r\n\r\n  /**\r\n   * Start a continuous BLE scan. Fires `onBeaconFound` events as beacons are detected.\r\n   * Call stopContinuousScan() to end the scan.\r\n   */\r\n  startContinuousScan(): void;\r\n\r\n  /** Stop the continuous scan started by startContinuousScan(). */\r\n  stopContinuousScan(): void;\r\n\r\n  /**\r\n   * Cancel any in-progress one-shot scan (iBeacon or Eddystone).\r\n   * The pending promise will be rejected with code \"SCAN_CANCELLED\".\r\n   */\r\n  cancelScan(): void;\r\n\r\n  /** Request Bluetooth + Location permissions. Returns true if granted. */\r\n  requestPermissionsAsync(): Promise<boolean>;\r\n\r\n  /**\r\n   * Check whether the app is exempt from Android battery optimizations.\r\n   * Always returns true on iOS and web (no equivalent concept).\r\n   */\r\n  isBatteryOptimizationExempt(): boolean;\r\n\r\n  /**\r\n   * Request exemption from Android battery optimizations.\r\n   * Opens the system dialog asking the user to whitelist this app.\r\n   * Returns true if the dialog was shown (or already exempt), false on failure.\r\n   * Always resolves true on iOS and web.\r\n   */\r\n  requestBatteryOptimizationExemption(): Promise<boolean>;\r\n\r\n  /** Enable SQLite event logging. All beacon events will be persisted to a local database. */\r\n  enableEventLogging(): void;\r\n\r\n  /** Disable event logging. Previously logged events are retained. */\r\n  disableEventLogging(): void;\r\n\r\n  /**\r\n   * Retrieve logged beacon events from the SQLite database.\r\n   * @param options Optional filters (limit, eventType, sinceTimestamp).\r\n   */\r\n  getEventLogs(options?: EventLogQueryOptions): EventLogEntry[];\r\n\r\n  /** Delete all logged events from the database. */\r\n  clearEventLogs(): void;\r\n\r\n  /** Delete the entire event log database. Also disables logging. */\r\n  destroyEventLogs(): void;\r\n\r\n  /**\r\n   * Configure a remote API endpoint for native event forwarding.\r\n   * Once set, enter/exit/timeout events are POSTed directly from native code,\r\n   * ensuring delivery even when the JS bridge is not active (app backgrounded).\r\n   *\r\n   * @param url The API endpoint URL to POST events to.\r\n   * @param apiKey Optional API key sent as X-API-Key header.\r\n   */\r\n  setApiEndpoint(url: string, apiKey?: string): void;\r\n}\r\n\r\nexport default requireNativeModule<ExpoBeaconModule>(\"ExpoBeacon\");\r\n"]}
+{"version":3,"file":"ExpoBeaconModule.js","sourceRoot":"","sources":["../src/ExpoBeaconModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAuKzD,eAAe,mBAAmB,CAAmB,YAAY,CAAC,CAAC","sourcesContent":["import { NativeModule, requireNativeModule } from \"expo\";\r\n\r\nimport {\r\n  ExpoBeaconModuleEvents,\r\n  BeaconScanResult,\r\n  EddystoneScanResult,\r\n  PairedBeacon,\r\n  PairedEddystone,\r\n  NotificationConfig,\r\n  MonitoringOptions,\r\n  EventLogQueryOptions,\r\n  EventLogEntry,\r\n} from \"./ExpoBeacon.types\";\r\n\r\ndeclare class ExpoBeaconModule extends NativeModule<ExpoBeaconModuleEvents> {\r\n  /**\r\n   * Start a one-shot iBeacon scan. Resolves with discovered beacons after scanDuration ms.\r\n   *\r\n   * Pass one or more UUIDs to scan for specific beacons (uses CoreLocation on iOS).\r\n   * On iOS, at least one UUID is required — Apple strips iBeacon data from BLE\r\n   * advertisements, making wildcard discovery impossible. When you pass an empty\r\n   * array, the module automatically uses UUIDs from paired beacons.\r\n   * On Android, pass an empty array to discover all nearby iBeacons.\r\n   *\r\n   * @param uuids Proximity UUIDs to filter by. Empty/omitted = use paired UUIDs (iOS) or wildcard (Android).\r\n   * @param scanDuration Duration in ms (default 5000)\r\n   */\r\n  scanForBeaconsAsync(\r\n    uuids?: string[],\r\n    scanDuration?: number,\r\n  ): Promise<BeaconScanResult[]>;\r\n\r\n  /**\r\n   * Start a one-shot Eddystone beacon scan using BLE.\r\n   * Discovers Eddystone-UID and Eddystone-URL frames.\r\n   *\r\n   * @param scanDuration Duration in ms (default 5000)\r\n   */\r\n  scanForEddystonesAsync(\r\n    scanDuration?: number,\r\n  ): Promise<EddystoneScanResult[]>;\r\n\r\n  /**\r\n   * Register a beacon for persistent region monitoring.\r\n   */\r\n  pairBeacon(\r\n    identifier: string,\r\n    uuid: string,\r\n    major: number,\r\n    minor: number,\r\n    name?: string,\r\n    timeoutSeconds?: number,\r\n  ): void;\r\n\r\n  /**\r\n   * Remove a previously paired beacon.\r\n   */\r\n  unpairBeacon(identifier: string): void;\r\n\r\n  /**\r\n   * Return all currently paired beacons.\r\n   */\r\n  getPairedBeacons(): PairedBeacon[];\r\n\r\n  /**\r\n   * Register an Eddystone-UID beacon for persistent monitoring.\r\n   */\r\n  pairEddystone(\r\n    identifier: string,\r\n    namespace: string,\r\n    instance: string,\r\n    name?: string,\r\n    timeoutSeconds?: number,\r\n  ): void;\r\n\r\n  /**\r\n   * Remove a previously paired Eddystone beacon.\r\n   */\r\n  unpairEddystone(identifier: string): void;\r\n\r\n  /**\r\n   * Return all currently paired Eddystone beacons.\r\n   */\r\n  getPairedEddystones(): PairedEddystone[];\r\n\r\n  /**\r\n   * Set persistent notification configuration. Settings are saved and applied to all\r\n   * subsequent monitoring sessions until explicitly changed.\r\n   */\r\n  setNotificationConfig(config: NotificationConfig): void;\r\n\r\n  /**\r\n   * Start background region monitoring for all paired beacons.\r\n   * On Android starts a foreground service.\r\n   * On iOS starts CLLocationManager region monitoring.\r\n   *\r\n   * Accepts a plain number (backward-compatible maxDistance shorthand) or a\r\n   * MonitoringOptions object with maxDistance and/or notification overrides.\r\n   */\r\n  startMonitoring(options?: MonitoringOptions | number): Promise<void>;\r\n\r\n  /**\r\n   * Stop background region monitoring.\r\n   */\r\n  stopMonitoring(): Promise<void>;\r\n\r\n  /**\r\n   * Start a continuous BLE scan. Fires `onBeaconFound` events as beacons are detected.\r\n   * Call stopContinuousScan() to end the scan.\r\n   */\r\n  startContinuousScan(): void;\r\n\r\n  /** Stop the continuous scan started by startContinuousScan(). */\r\n  stopContinuousScan(): void;\r\n\r\n  /**\r\n   * Cancel any in-progress one-shot scan (iBeacon or Eddystone).\r\n   * The pending promise will be rejected with code \"SCAN_CANCELLED\".\r\n   */\r\n  cancelScan(): void;\r\n\r\n  /** Request Bluetooth + Location permissions. Returns true if granted. */\r\n  requestPermissionsAsync(): Promise<boolean>;\r\n\r\n  /**\r\n   * Check whether the app is exempt from Android battery optimizations.\r\n   * Always returns true on iOS and web (no equivalent concept).\r\n   */\r\n  isBatteryOptimizationExempt(): boolean;\r\n\r\n  /**\r\n   * Request exemption from Android battery optimizations.\r\n   * Opens the system dialog asking the user to whitelist this app.\r\n   * Returns true if the dialog was shown (or already exempt), false on failure.\r\n   * Always resolves true on iOS and web.\r\n   */\r\n  requestBatteryOptimizationExemption(): Promise<boolean>;\r\n\r\n  /** Enable SQLite event logging. All beacon events will be persisted to a local database. */\r\n  enableEventLogging(): void;\r\n\r\n  /** Disable event logging. Previously logged events are retained. */\r\n  disableEventLogging(): void;\r\n\r\n  /**\r\n   * Retrieve logged beacon events from the SQLite database.\r\n   * @param options Optional filters (limit, eventType, sinceTimestamp).\r\n   */\r\n  getEventLogs(options?: EventLogQueryOptions): EventLogEntry[];\r\n\r\n  /** Delete all logged events from the database. */\r\n  clearEventLogs(): void;\r\n\r\n  /** Delete the entire event log database. Also disables logging. */\r\n  destroyEventLogs(): void;\r\n\r\n  /**\r\n   * Configure a remote API endpoint for native event forwarding.\r\n   * Once set, beacon events are POSTed directly from native code,\r\n   * ensuring delivery even when the JS bridge is not active (app backgrounded).\r\n   *\r\n   * @param url The API endpoint URL to POST events to.\r\n   * @param apiKey Optional API key sent as X-API-Key header.\r\n   */\r\n  setApiEndpoint(url: string, apiKey?: string): void;\r\n}\r\n\r\nexport default requireNativeModule<ExpoBeaconModule>(\"ExpoBeacon\");\r\n"]}

package/ios/ExpoBeaconModule.swift

@@ -12,6 +12,7 @@ private let EXIT_DISTANCE_KEY = "expo.beacon.exit_distance"
 private let NOTIFICATION_CONFIG_KEY = "expo.beacon.notification_config"
 private let EVENT_LOGGING_ENABLED_KEY = "expo.beacon.event_logging_enabled"
 private let MIN_RSSI_KEY = "expo.beacon.min_rssi"
+private let EVENT_LEVEL_KEY = "expo.beacon.event_level"
 
 /// Default minimum RSSI (dBm) below which beacon readings are discarded as unreliable.
 private let DEFAULT_MIN_RSSI: Int = -85
@@ -34,6 +35,9 @@ private let EDDYSTONE_MONITORING_TICK_INTERVAL: TimeInterval = 2.0
 private let EDDYSTONE_RECENTLY_SEEN_THRESHOLD: TimeInterval = 15.0
 /// Minimum interval between consecutive distance event emissions per identifier.
 private let DISTANCE_EVENT_THROTTLE_INTERVAL: TimeInterval = 1.0
+/// Seconds of no valid BLE readings before starting the timeout countdown.
+/// Acts as a safety net when ranging cycles stop entirely (e.g. Doze mode).
+private let DISTANCE_INACTIVITY_SECONDS: TimeInterval = 60.0
 
 public class ExpoBeaconModule: Module {
 
@@ -98,6 +102,9 @@ public class ExpoBeaconModule: Module {
     /// Minimum RSSI threshold — readings below this are treated as unreliable.
     private var minRssiThreshold: Int = DEFAULT_MIN_RSSI
 
+    /// Event level: "all" emits distance + enter/exit/timeout; "events" suppresses distance.
+    private var eventLevel: String = "all"
+
     /// Distance smoothing (EMA) state per identifier.
     private var smoothedDistances: [String: Double] = [:]
     /// EMA weight for new readings. 0.4 balances responsiveness vs noise rejection.
@@ -122,6 +129,9 @@ public class ExpoBeaconModule: Module {
     // Timeout timers — fire once after beacon stays in range for configured duration
     private var beaconTimeoutTimers: [String: DispatchWorkItem] = [:]
     private var eddystoneTimeoutTimers: [String: DispatchWorkItem] = [:]
+    // Inactivity timers — start timeout countdown when no BLE readings for 60 s
+    private var beaconInactivityTimers: [String: DispatchWorkItem] = [:]
+    private var eddystoneInactivityTimers: [String: DispatchWorkItem] = [:]
 
     // Custom UserDefaults suite to isolate beacon data from the host app's .standard
     private lazy var defaults: UserDefaults = {
@@ -331,6 +341,13 @@ public class ExpoBeaconModule: Module {
                 maxDistance = map["maxDistance"] as? Double
                 exitDistance = map["exitDistance"] as? Double
                 minRssi = map["minRssi"] as? Int
+                if let lvl = map["level"] as? String, lvl == "events" || lvl == "all" {
+                    self.eventLevel = lvl
+                    self.defaults.set(lvl, forKey: EVENT_LEVEL_KEY)
+                } else {
+                    self.eventLevel = "all"
+                    self.defaults.set("all", forKey: EVENT_LEVEL_KEY)
+                }
                 if let notifications = map["notifications"] as? [String: Any],
                    let data = try? JSONSerialization.data(withJSONObject: notifications),
                    let json = String(data: data, encoding: .utf8) {
@@ -392,6 +409,8 @@ public class ExpoBeaconModule: Module {
             self.defaults.set(false, forKey: IS_MONITORING_KEY)
             self.defaults.removeObject(forKey: MAX_DISTANCE_KEY)
             self.defaults.removeObject(forKey: EXIT_DISTANCE_KEY)
+            self.defaults.removeObject(forKey: EVENT_LEVEL_KEY)
+            self.eventLevel = "all"
             self.stopRegionMonitoring()
             promise.resolve(nil)
         }
@@ -575,6 +594,9 @@ public class ExpoBeaconModule: Module {
         let storedRssi = defaults.object(forKey: MIN_RSSI_KEY) as? Int
         minRssiThreshold = storedRssi ?? DEFAULT_MIN_RSSI
 
+        // Restore persisted event level (survives app restarts)
+        eventLevel = defaults.string(forKey: EVENT_LEVEL_KEY) ?? "all"
+
         let beacons = loadPairedBeaconsRaw()
 
         // CLLocationManager supports a maximum of 20 monitored regions.
@@ -642,6 +664,9 @@ public class ExpoBeaconModule: Module {
         for timer in beaconTimeoutTimers.values { timer.cancel() }
         beaconTimeoutTimers.removeAll()
 
+        for timer in beaconInactivityTimers.values { timer.cancel() }
+        beaconInactivityTimers.removeAll()
+
         stopEddystoneMonitoring()
     }
 
@@ -810,6 +835,8 @@ public class ExpoBeaconModule: Module {
 
             eddystoneLatestSeen[identifier] = Date()
             eddystoneMissCounters[identifier] = 0
+            // Valid BLE reading — reset inactivity timer.
+            rescheduleEddystoneInactivity(identifier: identifier, namespace: ns, instance: inst)
 
             // Distance-driven enter/exit with hysteresis — evaluated on every
             // BLE callback (not throttled) so the hysteresis counters advance
@@ -818,13 +845,10 @@ public class ExpoBeaconModule: Module {
             let exitDist = self.defaults.object(forKey: EXIT_DISTANCE_KEY) as? Double
             let hasValidDistance = distance.isFinite && distance >= 0
             if hasValidDistance || maxDist == nil {
-                // Apply EMA smoothing; jump guard returns nil for outliers
+                // Apply EMA smoothing; jump resets EMA to the new value
                 let effectiveDistance: Double
-                if hasValidDistance, let smoothed = smoothDistance(identifier: identifier, rawDistance: distance) {
-                    effectiveDistance = smoothed
-                } else if hasValidDistance {
-                    // Jump outlier — skip this cycle without resetting counters
-                    break
+                if hasValidDistance {
+                    effectiveDistance = smoothDistance(identifier: identifier, rawDistance: distance)!
                 } else {
                     effectiveDistance = distance
                 }
@@ -852,6 +876,7 @@ public class ExpoBeaconModule: Module {
                     cancelEddystoneTimeout(identifier: identifier)
                 case .exit:
                     smoothedDistances.removeValue(forKey: identifier)
+                    print("[ExpoBeacon] DEBUG: Eddystone distance-based EXIT for \(identifier)")
                     sendLoggedEvent("onEddystoneExit", [
                         "identifier": identifier,
                         "namespace": ns,
@@ -861,7 +886,8 @@ public class ExpoBeaconModule: Module {
                         "rssi": beaconRssi
                     ])
                     postBeaconNotification(identifier: identifier, eventType: "exit")
-                    // Beacon left — start the timeout clock.
+                    // Beacon left — cancel inactivity timer and start the timeout clock.
+                    cancelEddystoneInactivity(identifier: identifier)
                     scheduleEddystoneTimeout(identifier: identifier, namespace: ns, instance: inst)
                 case .none:
                     break
@@ -869,6 +895,7 @@ public class ExpoBeaconModule: Module {
             }
 
             guard hasValidDistance else { break }
+            guard self.eventLevel == "all" else { break }
 
             // Throttle distance events — enter/exit above is evaluated on every
             // callback, but distance events are rate-limited to avoid flooding JS.
@@ -960,10 +987,8 @@ public class ExpoBeaconModule: Module {
             let identifier = params["identifier"] as? String
             getOrCreateEventLogger().logEvent(eventType: eventName, identifier: identifier, data: params)
         }
-        // Forward enter/exit/timeout events to remote API (skip distance — too frequent)
-        if !eventName.lowercased().contains("distance") {
-            apiForwarder.forwardEvent(params)
-        }
+        // Forward all produced events to remote API
+        apiForwarder.forwardEvent(params)
         sendEvent(eventName, params)
     }
 
@@ -1049,6 +1074,9 @@ public class ExpoBeaconModule: Module {
         for timer in eddystoneTimeoutTimers.values { timer.cancel() }
         eddystoneTimeoutTimers.removeAll()
 
+        for timer in eddystoneInactivityTimers.values { timer.cancel() }
+        eddystoneInactivityTimers.removeAll()
+
         stopBleScanIfUnneeded()
     }
 
@@ -1093,8 +1121,10 @@ public class ExpoBeaconModule: Module {
                     "distance": -1
                 ]
                 sendLoggedEvent("onEddystoneExit", params)
+                print("[ExpoBeacon] DEBUG: Eddystone miss-based EXIT for \(identifier)")
                 postBeaconNotification(identifier: identifier, eventType: "exit")
-                // Beacon disappeared — start the timeout clock.
+                // Beacon disappeared — cancel inactivity timer and start the timeout clock.
+                cancelEddystoneInactivity(identifier: identifier)
                 scheduleEddystoneTimeout(identifier: identifier, namespace: ns, instance: inst)
             }
         }
@@ -1147,6 +1177,48 @@ public class ExpoBeaconModule: Module {
         eddystoneTimeoutTimers.removeValue(forKey: identifier)?.cancel()
     }
 
+    // MARK: - Inactivity timer helpers (no BLE readings → start timeout countdown)
+
+    private func rescheduleBeaconInactivity(identifier: String, beacon: CLBeacon? = nil, region: CLBeaconRegion? = nil) {
+        cancelBeaconInactivity(identifier: identifier)
+
+        let paired = loadPairedBeaconsRaw().first { ($0["identifier"] as? String) == identifier }
+        guard let seconds = paired?["timeoutSeconds"] as? Int, seconds > 0 else { return }
+
+        let work = DispatchWorkItem { [weak self] in
+            guard let self = self else { return }
+            self.beaconInactivityTimers.removeValue(forKey: identifier)
+            // No BLE readings for 60 s — start the configured timeout countdown.
+            self.scheduleBeaconTimeout(identifier: identifier, beacon: beacon, region: region)
+        }
+        beaconInactivityTimers[identifier] = work
+        DispatchQueue.main.asyncAfter(deadline: .now() + DISTANCE_INACTIVITY_SECONDS, execute: work)
+    }
+
+    private func rescheduleEddystoneInactivity(identifier: String, namespace: String, instance: String) {
+        cancelEddystoneInactivity(identifier: identifier)
+
+        let paired = loadPairedEddystonesRaw().first { ($0["identifier"] as? String) == identifier }
+        guard let seconds = paired?["timeoutSeconds"] as? Int, seconds > 0 else { return }
+
+        let work = DispatchWorkItem { [weak self] in
+            guard let self = self else { return }
+            self.eddystoneInactivityTimers.removeValue(forKey: identifier)
+            // No BLE readings for 60 s — start the configured timeout countdown.
+            self.scheduleEddystoneTimeout(identifier: identifier, namespace: namespace, instance: instance)
+        }
+        eddystoneInactivityTimers[identifier] = work
+        DispatchQueue.main.asyncAfter(deadline: .now() + DISTANCE_INACTIVITY_SECONDS, execute: work)
+    }
+
+    private func cancelBeaconInactivity(identifier: String) {
+        beaconInactivityTimers.removeValue(forKey: identifier)?.cancel()
+    }
+
+    private func cancelEddystoneInactivity(identifier: String) {
+        eddystoneInactivityTimers.removeValue(forKey: identifier)?.cancel()
+    }
+
     private func postBeaconNotification(identifier: String, eventType: String) {
         let cfg = loadNotificationConfig()
         let eventsCfg = cfg["beaconEvents"] as? [String: Any]
@@ -1328,9 +1400,13 @@ public class ExpoBeaconModule: Module {
             if let beacon = validBeacon {
                 // Got a valid reading — reset miss counter
                 missCounters[identifier] = 0
+                // Valid BLE reading — reset inactivity timer.
+                rescheduleBeaconInactivity(identifier: identifier, beacon: beacon)
 
-                // Emit distance event every ranging cycle (~1 s)
-                sendLoggedEvent("onBeaconDistance", makeBeaconEventParams(identifier: identifier, beacon: beacon))
+                // Emit distance event every ranging cycle (~1 s) if level allows
+                if self.eventLevel == "all" {
+                    sendLoggedEvent("onBeaconDistance", makeBeaconEventParams(identifier: identifier, beacon: beacon))
+                }
 
                 // Enter/exit synthesis with hysteresis — always applied.
                 // When maxDistance is set, distance thresholds control transitions.
@@ -1339,11 +1415,8 @@ public class ExpoBeaconModule: Module {
                 let maxDist = self.defaults.object(forKey: MAX_DISTANCE_KEY) as? Double
                 let exitDist = self.defaults.object(forKey: EXIT_DISTANCE_KEY) as? Double
 
-                // Apply EMA smoothing; jump guard returns nil for outliers
-                guard let smoothed = smoothDistance(identifier: identifier, rawDistance: beacon.accuracy) else {
-                    // Jump outlier — skip this cycle without resetting counters
-                    return
-                }
+                // Apply EMA smoothing; jump resets EMA to the new value
+                let smoothed = smoothDistance(identifier: identifier, rawDistance: beacon.accuracy)!
 
                 let action = evaluateDistanceHysteresis(
                     identifier: identifier,
@@ -1364,7 +1437,8 @@ public class ExpoBeaconModule: Module {
                     smoothedDistances.removeValue(forKey: identifier)
                     sendLoggedEvent("onBeaconExit", makeBeaconEventParams(identifier: identifier, beacon: beacon, event: "exit"))
                     postBeaconNotification(identifier: identifier, eventType: "exit")
-                    // Beacon left — start the timeout clock.
+                    // Beacon left — cancel inactivity timer and start the timeout clock.
+                    cancelBeaconInactivity(identifier: identifier)
                     scheduleBeaconTimeout(identifier: identifier, beacon: beacon)
                 case .none:
                     break
@@ -1392,7 +1466,8 @@ public class ExpoBeaconModule: Module {
                     let region = monitoredRegions.first { $0.identifier == identifier }
                     sendLoggedEvent("onBeaconExit", makeBeaconEventParams(identifier: identifier, region: region, event: "exit"))
                     postBeaconNotification(identifier: identifier, eventType: "exit")
-                    // Beacon disappeared — start the timeout clock.
+                    // Beacon disappeared — cancel inactivity timer and start the timeout clock.
+                    cancelBeaconInactivity(identifier: identifier)
                     scheduleBeaconTimeout(identifier: identifier, region: region)
                 }
             }
@@ -1438,7 +1513,8 @@ public class ExpoBeaconModule: Module {
         if wasEntered {
             sendLoggedEvent("onBeaconExit", makeBeaconEventParams(identifier: identifier, region: beaconRegion, event: "exit"))
             postBeaconNotification(identifier: identifier, eventType: "exit")
-            // OS-level exit safety net — start the timeout clock.
+            // OS-level exit safety net — cancel inactivity timer and start the timeout clock.
+            cancelBeaconInactivity(identifier: identifier)
             scheduleBeaconTimeout(identifier: identifier, region: beaconRegion)
         }
     }

package/package.json

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

package/src/ExpoBeacon.types.ts

@@ -27,6 +27,9 @@ export type PairedBeacon = {
    * Timeout in seconds. When set, the module fires `onBeaconTimeout` once
    * after the beacon has been continuously in range for this duration.
    * The timer resets if the beacon exits and re-enters range.
+   *
+   * The timeout countdown also starts if no BLE readings are received
+   * for 60 seconds (e.g. due to Doze mode or background throttling).
    */
   timeoutSeconds?: number;
 };
@@ -141,6 +144,13 @@ export type MonitoringOptions = {
    * Default: -85. Typical range: -100 (very permissive) to -70 (strict).
    */
   minRssi?: number;
+  /**
+   * Controls which event types are emitted, logged, and forwarded to the API.
+   *
+   * - `'all'` (default): distance + enter + exit + timeout events.
+   * - `'events'`: enter + exit + timeout only (no distance events).
+   */
+  level?: 'all' | 'events';
   /** Notification configuration overrides to apply for this monitoring session. */
   notifications?: NotificationConfig;
 };
@@ -182,6 +192,9 @@ export type PairedEddystone = {
    * Timeout in seconds. When set, the module fires `onEddystoneTimeout` once
    * after the beacon has been continuously in range for this duration.
    * The timer resets if the beacon exits and re-enters range.
+   *
+   * The timeout countdown also starts if no BLE readings are received
+   * for 60 seconds (e.g. due to Doze mode or background throttling).
    */
   timeoutSeconds?: number;
 };

package/src/ExpoBeaconModule.ts

@@ -156,7 +156,7 @@ declare class ExpoBeaconModule extends NativeModule<ExpoBeaconModuleEvents> {
 
   /**
    * Configure a remote API endpoint for native event forwarding.
-   * Once set, enter/exit/timeout events are POSTed directly from native code,
+   * Once set, beacon events are POSTed directly from native code,
    * ensuring delivery even when the JS bridge is not active (app backgrounded).
    *
    * @param url The API endpoint URL to POST events to.