expo-beacon 0.7.23 → 0.7.25

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

@@ -1,10 +1,10 @@
 package expo.modules.beacon
 
 // Shared constants used across ExpoBeaconModule and BeaconForegroundService.
-// NOTE: EXIT_MISS_THRESHOLD and scan timing deviate from iOS intentionally —
-// Android requires a non-zero between-scan gap to prevent OS-level BLE
-// throttling, and a higher miss threshold to tolerate brief scan pauses.
-// HYSTERESIS_COUNT should stay in sync with ExpoBeaconModule.swift (iOS).
+// NOTE: Scan timing deviates from iOS intentionally — Android requires a non-zero
+// between-scan gap to prevent OS-level BLE throttling.
+// ENTER_HYSTERESIS_COUNT and EXIT_HYSTERESIS_COUNT should stay in sync with
+// ExpoBeaconModule.swift (iOS).
 
 internal const val PREFS_NAME = "expo.beacon.paired"
 internal const val PREFS_KEY = "paired_beacons"
@@ -42,22 +42,19 @@ internal const val REGION_EXIT_PERIOD_MS = 60000L
  */
 internal const val RECENT_RANGING_SIGHTING_GRACE_MS = REGION_EXIT_PERIOD_MS
 
-/**
- * Number of consecutive ranging misses before emitting a distance-based exit event.
- * With a ~2.1 s scan cycle (1100 ms scan + 1000 ms gap), 10 misses ≈ 21 s of
- * silence before declaring exit — tolerant of brief BLE gaps while still
- * responsive to actual departures.
- */
-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
+/** Number of consecutive in-range readings required to confirm a distance-based enter transition. */
+internal const val ENTER_HYSTERESIS_COUNT = 1
+/** Number of consecutive out-of-range readings required to confirm a distance-based exit transition. */
+internal const val EXIT_HYSTERESIS_COUNT = 3
+
+/** Default seconds of silence after last sighting before a disappearance-based exit fires. */
+internal const val DEFAULT_EXIT_TIMEOUT_SECONDS = 300.0
 
 /** Default minimum RSSI (dBm) below which beacon readings are discarded as unreliable. */
 internal const val DEFAULT_MIN_RSSI = -85

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

@@ -10,8 +10,10 @@ interface BeaconEventPlugin {
     // iBeacon
     fun onBeaconEnter(identifier: String, uuid: String, major: Int, minor: Int, distance: Double)
     fun onBeaconExit(identifier: String, uuid: String, major: Int, minor: Int, distance: Double)
+    fun onBeaconTimeout(identifier: String, uuid: String, major: Int, minor: Int, distance: Double)
 
     // Eddystone
     fun onEddystoneEnter(identifier: String, namespace: String, instance: String, distance: Double)
     fun onEddystoneExit(identifier: String, namespace: String, instance: String, distance: Double)
+    fun onEddystoneTimeout(identifier: String, namespace: String, instance: String, distance: Double)
 }

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

@@ -81,6 +81,8 @@ class BeaconForegroundService : Service(), BeaconConsumer {
     private var apiForwarder: BeaconApiForwarder? = null
     // Event level: "all" emits distance + enter/exit/timeout; "events" suppresses distance.
     @Volatile private var eventLevel: String = "all"
+    // Seconds of silence after last valid sighting before a disappearance-based exit fires.
+    @Volatile private var exitTimeoutMs: Long = (DEFAULT_EXIT_TIMEOUT_SECONDS * 1000.0).toLong()
 
     override fun onCreate() {
         super.onCreate()
@@ -187,6 +189,7 @@ class BeaconForegroundService : Service(), BeaconConsumer {
         exitDistance = optPrefs.getString("exit_distance", null)?.toDoubleOrNull()
         minRssiThreshold = optPrefs.getInt("min_rssi", DEFAULT_MIN_RSSI)
         eventLevel = optPrefs.getString("level", "all") ?: "all"
+        exitTimeoutMs = ((optPrefs.getString("exit_timeout_seconds", null)?.toDoubleOrNull() ?: DEFAULT_EXIT_TIMEOUT_SECONDS) * 1000.0).toLong()
 
         beaconManager.addMonitorNotifier(monitorNotifier)
         beaconManager.addRangeNotifier(rangeNotifier)
@@ -442,14 +445,16 @@ class BeaconForegroundService : Service(), BeaconConsumer {
                 // On Android 17+ (API 37) the BLE scan callbacks are more intermittent: valid
                 // readings are interspersed with occasional null cycles even when the beacon is
                 // nearby. Resetting direction counters on every null would prevent the hysteresis
-                // from ever accumulating to HYSTERESIS_COUNT, breaking enter/exit entirely while
+                // from ever accumulating to ENTER_HYSTERESIS_COUNT, breaking enter/exit entirely while
                 // still allowing distance events (which fire on each individual valid reading).
                 // Direction counters are reset by evaluateDistanceHysteresis when a valid reading
                 // contradicts the current direction (e.g., in-range reading resets exitCounters).
                 val count = (missCounters[region.uniqueId] ?: 0) + 1
                 missCounters[region.uniqueId] = count
 
-                if (enteredRegions.contains(region.uniqueId) && count >= EXIT_MISS_THRESHOLD) {
+                val lastSeen = lastSeenAtMs[region.uniqueId]
+                val silentMs = if (lastSeen != null) SystemClock.elapsedRealtime() - lastSeen else Long.MAX_VALUE
+                if (enteredRegions.contains(region.uniqueId) && silentMs >= exitTimeoutMs) {
                     enteredRegions.remove(region.uniqueId)
                     missCounters[region.uniqueId] = 0
                     enterCounters[region.uniqueId] = 0
@@ -520,7 +525,7 @@ class BeaconForegroundService : Service(), BeaconConsumer {
             }
             val count = (enterCounters[regionId] ?: 0) + 1
             enterCounters[regionId] = count
-            if (count >= HYSTERESIS_COUNT) {
+            if (count >= ENTER_HYSTERESIS_COUNT) {
                 enterCounters[regionId] = 0
                 return HysteresisAction.ENTER
             }
@@ -533,7 +538,7 @@ class BeaconForegroundService : Service(), BeaconConsumer {
             exitCounters[regionId] = 0
             val count = (enterCounters[regionId] ?: 0) + 1
             enterCounters[regionId] = count
-            if (!enteredRegions.contains(regionId) && count >= HYSTERESIS_COUNT) {
+            if (!enteredRegions.contains(regionId) && count >= ENTER_HYSTERESIS_COUNT) {
                 enterCounters[regionId] = 0
                 return HysteresisAction.ENTER
             }
@@ -542,7 +547,7 @@ class BeaconForegroundService : Service(), BeaconConsumer {
             enterCounters[regionId] = 0
             val count = (exitCounters[regionId] ?: 0) + 1
             exitCounters[regionId] = count
-            if (enteredRegions.contains(regionId) && count >= HYSTERESIS_COUNT) {
+            if (enteredRegions.contains(regionId) && count >= EXIT_HYSTERESIS_COUNT) {
                 exitCounters[regionId] = 0
                 return HysteresisAction.EXIT
             }
@@ -628,18 +633,18 @@ class BeaconForegroundService : Service(), BeaconConsumer {
         // Forward all produced events to remote API
         apiForwarder?.forwardEvent(params)
 
-        // Dispatch enter/exit to registered plugins (e.g. to start/stop BGLocation)
-        if (eventType == "enter" || eventType == "exit") {
+        // Dispatch enter/exit/timeout to registered plugins (e.g. to start/stop BGLocation)
+        if (eventType == "enter" || eventType == "exit" || eventType == "timeout") {
             val identifier = region.uniqueId
             val uuid = if (!isEddystone) id1Str else ""
             val major = if (!isEddystone) region.id2?.toInt() ?: 0 else 0
             val minor = if (!isEddystone) region.id3?.toInt() ?: 0 else 0
             val namespace = if (isEddystone) id1Str.removePrefix("0x") else ""
             val instance = if (isEddystone) region.id2?.toString()?.removePrefix("0x") ?: "" else ""
-            if (eventType == "enter") {
-                BeaconPluginRegistry.dispatchEnter(isEddystone, identifier, uuid, major, minor, namespace, instance, distance)
-            } else {
-                BeaconPluginRegistry.dispatchExit(isEddystone, identifier, uuid, major, minor, namespace, instance, distance)
+            when (eventType) {
+                "enter" -> BeaconPluginRegistry.dispatchEnter(isEddystone, identifier, uuid, major, minor, namespace, instance, distance)
+                "exit" -> BeaconPluginRegistry.dispatchExit(isEddystone, identifier, uuid, major, minor, namespace, instance, distance)
+                "timeout" -> BeaconPluginRegistry.dispatchTimeout(isEddystone, identifier, uuid, major, minor, namespace, instance, distance)
             }
         }
 

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

@@ -58,4 +58,23 @@ object BeaconPluginRegistry {
             }
         }
     }
+
+    internal fun dispatchTimeout(
+        isEddystone: Boolean,
+        identifier: String,
+        uuid: String,
+        major: Int,
+        minor: Int,
+        namespace: String,
+        instance: String,
+        distance: Double,
+    ) {
+        plugins.forEach { plugin ->
+            if (isEddystone) {
+                plugin.onEddystoneTimeout(identifier, namespace, instance, distance)
+            } else {
+                plugin.onBeaconTimeout(identifier, uuid, major, minor, distance)
+            }
+        }
+    }
 }

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

@@ -290,6 +290,7 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
             var exitDistance: Double? = null
             var minRssi: Int? = null
             var level: String = "all"
+            var exitTimeoutSeconds: Double? = null
             when (options) {
                 is Double -> maxDistance = options
                 is Map<*, *> -> {
@@ -299,6 +300,7 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
                     exitDistance = (map["exitDistance"] as? Number)?.toDouble()
                     minRssi = (map["minRssi"] as? Number)?.toInt()
                     level = (map["level"] as? String) ?: "all"
+                    exitTimeoutSeconds = (map["exitTimeoutSeconds"] as? Number)?.toDouble()
                     val notifications = map["notifications"]
                     if (notifications is Map<*, *>) {
                         @Suppress("UNCHECKED_CAST")
@@ -327,6 +329,11 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
                 sendEvent("onBeaconError", mapOf("identifier" to "", "code" to "INVALID_EXIT_DISTANCE", "message" to "exitDistance must be greater than or equal to maxDistance"))
                 return@AsyncFunction
             }
+            if (exitTimeoutSeconds != null && (!exitTimeoutSeconds.isFinite() || exitTimeoutSeconds <= 0.0)) {
+                promise.reject("INVALID_EXIT_TIMEOUT", "exitTimeoutSeconds must be a finite number greater than 0", null)
+                sendEvent("onBeaconError", mapOf("identifier" to "", "code" to "INVALID_EXIT_TIMEOUT", "message" to "exitTimeoutSeconds must be a finite number greater than 0"))
+                return@AsyncFunction
+            }
             ctx.getSharedPreferences(MONITORING_OPTIONS_PREFS, Context.MODE_PRIVATE)
                 .edit().apply {
                     if (maxDistance != null) putString("max_distance", maxDistance.toString())
@@ -336,6 +343,8 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
                     if (minRssi != null) putInt("min_rssi", minRssi)
                     else remove("min_rssi")
                     putString("level", level)
+                    if (exitTimeoutSeconds != null) putString("exit_timeout_seconds", exitTimeoutSeconds.toString())
+                    else remove("exit_timeout_seconds")
                 }.apply()
             // Verify we have the permissions needed for background monitoring
             val hasLocation = ContextCompat.checkSelfPermission(ctx, Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED
@@ -495,6 +504,7 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
                 optPrefs.getString("exit_distance", null)?.toDoubleOrNull()?.let { put("exitDistance", it) }
                 if (optPrefs.contains("min_rssi")) put("minRssi", optPrefs.getInt("min_rssi", -85))
                 optPrefs.getString("level", null)?.let { put("level", it) }
+                optPrefs.getString("exit_timeout_seconds", null)?.toDoubleOrNull()?.let { put("exitTimeoutSeconds", it) }
                 val json = ctx.getSharedPreferences(NOTIFICATION_CONFIG_PREFS, Context.MODE_PRIVATE)
                     .getString("config", null)
                 if (json != null) {

package/build/ExpoBeacon.types.d.ts

@@ -121,6 +121,8 @@ export type MonitoringConfig = {
     exitDistance?: number;
     minRssi?: number;
     level?: 'all' | 'events';
+    /** Seconds after last beacon sighting before an exit event fires. Default: 300. */
+    exitTimeoutSeconds?: number;
     notifications?: NotificationConfig;
 };
 /** Current state snapshot for a paired monitored device. */
@@ -173,6 +175,13 @@ export type MonitoringOptions = {
      * - `'events'`: enter + exit + timeout only (no distance events).
      */
     level?: 'all' | 'events';
+    /**
+     * Seconds after last beacon sighting before an exit event fires when the beacon
+     * disappears without moving outside the exit distance threshold.
+     *
+     * Default: 300 (5 minutes). Minimum: 1.
+     */
+    exitTimeoutSeconds?: number;
     /** Notification configuration overrides to apply for this monitoring session. */
     notifications?: NotificationConfig;
 };

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   * 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  /** Notification title on beacon timeout. Default: \"Beacon Timeout\". */\r\n  timeoutTitle?: 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/** Snapshot of the current monitoring configuration and active state. */\r\nexport type MonitoringConfig = {\r\n  /** Whether background monitoring is currently active. */\r\n  isMonitoring: boolean;\r\n  maxDistance?: number;\r\n  exitDistance?: number;\r\n  minRssi?: number;\r\n  level?: 'all' | 'events';\r\n  notifications?: NotificationConfig;\r\n};\r\n\r\n/** Current state snapshot for a paired monitored device. */\r\nexport type MonitoredDeviceState =\r\n  | {\r\n      kind: \"ibeacon\";\r\n      identifier: string;\r\n      uuid: string;\r\n      major: number;\r\n      minor: number;\r\n      state: \"entered\" | \"exited\";\r\n      /** Current distance in metres, or null when exited or no live reading is available. */\r\n      distance: number | null;\r\n    }\r\n  | {\r\n      kind: \"eddystone\";\r\n      identifier: string;\r\n      namespace: string;\r\n      instance: string;\r\n      state: \"entered\" | \"exited\";\r\n      /** Current distance in metres, or null when exited or no live reading is available. */\r\n      distance: number | null;\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/** Payload for native beacon error events (monitoring/ranging failures). */\r\nexport type BeaconErrorEvent = {\r\n  /** Region or constraint identifier, empty string if unavailable. */\r\n  identifier: string;\r\n  /** Machine-readable error code (e.g. \"MONITORING_FAILED\", \"RANGING_FAILED\", \"SECURITY_EXCEPTION\"). */\r\n  code: string;\r\n  /** Human-readable error message from the native layer. */\r\n  message: string;\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  /** Fired when a native monitoring or ranging failure occurs (logged to DB and forwarded to JS). */\r\n  onBeaconError: (params: BeaconErrorEvent) => 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  /** Notification title on beacon timeout. Default: \"Beacon Timeout\". */\r\n  timeoutTitle?: 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/** Snapshot of the current monitoring configuration and active state. */\r\nexport type MonitoringConfig = {\r\n  /** Whether background monitoring is currently active. */\r\n  isMonitoring: boolean;\r\n  maxDistance?: number;\r\n  exitDistance?: number;\r\n  minRssi?: number;\r\n  level?: 'all' | 'events';\r\n  /** Seconds after last beacon sighting before an exit event fires. Default: 300. */\r\n  exitTimeoutSeconds?: number;\r\n  notifications?: NotificationConfig;\r\n};\r\n\r\n/** Current state snapshot for a paired monitored device. */\r\nexport type MonitoredDeviceState =\r\n  | {\r\n      kind: \"ibeacon\";\r\n      identifier: string;\r\n      uuid: string;\r\n      major: number;\r\n      minor: number;\r\n      state: \"entered\" | \"exited\";\r\n      /** Current distance in metres, or null when exited or no live reading is available. */\r\n      distance: number | null;\r\n    }\r\n  | {\r\n      kind: \"eddystone\";\r\n      identifier: string;\r\n      namespace: string;\r\n      instance: string;\r\n      state: \"entered\" | \"exited\";\r\n      /** Current distance in metres, or null when exited or no live reading is available. */\r\n      distance: number | null;\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  /**\r\n   * Seconds after last beacon sighting before an exit event fires when the beacon\r\n   * disappears without moving outside the exit distance threshold.\r\n   *\r\n   * Default: 300 (5 minutes). Minimum: 1.\r\n   */\r\n  exitTimeoutSeconds?: 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   * 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/** Payload for native beacon error events (monitoring/ranging failures). */\r\nexport type BeaconErrorEvent = {\r\n  /** Region or constraint identifier, empty string if unavailable. */\r\n  identifier: string;\r\n  /** Machine-readable error code (e.g. \"MONITORING_FAILED\", \"RANGING_FAILED\", \"SECURITY_EXCEPTION\"). */\r\n  code: string;\r\n  /** Human-readable error message from the native layer. */\r\n  message: string;\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  /** Fired when a native monitoring or ranging failure occurs (logged to DB and forwarded to JS). */\r\n  onBeaconError: (params: BeaconErrorEvent) => 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/ios/BeaconLifecycleDelegate.swift

@@ -9,10 +9,12 @@ public protocol BeaconLifecycleDelegate: AnyObject {
     // MARK: iBeacon
     func beaconDidEnter(identifier: String, uuid: String, major: Int, minor: Int, distance: Double)
     func beaconDidExit(identifier: String, uuid: String, major: Int, minor: Int, distance: Double)
+    func beaconDidTimeout(identifier: String, uuid: String, major: Int, minor: Int, distance: Double)
 
     // MARK: Eddystone
     func eddystoneDidEnter(identifier: String, namespace: String, instance: String, distance: Double)
     func eddystoneDidExit(identifier: String, namespace: String, instance: String, distance: Double)
+    func eddystoneDidTimeout(identifier: String, namespace: String, instance: String, distance: Double)
 }
 
 /// Thread-safe registry for [BeaconLifecycleDelegate] plugins.
@@ -46,6 +48,12 @@ public final class BeaconLifecycleRegistry {
     internal func dispatchEddystoneExit(identifier: String, namespace: String, instance: String, distance: Double) {
         snapshot().forEach { $0.eddystoneDidExit(identifier: identifier, namespace: namespace, instance: instance, distance: distance) }
     }
+    internal func dispatchBeaconTimeout(identifier: String, uuid: String, major: Int, minor: Int, distance: Double) {
+        snapshot().forEach { $0.beaconDidTimeout(identifier: identifier, uuid: uuid, major: major, minor: minor, distance: distance) }
+    }
+    internal func dispatchEddystoneTimeout(identifier: String, namespace: String, instance: String, distance: Double) {
+        snapshot().forEach { $0.eddystoneDidTimeout(identifier: identifier, namespace: namespace, instance: instance, distance: distance) }
+    }
 
     private func snapshot() -> [any BeaconLifecycleDelegate] {
         lock.lock(); defer { lock.unlock() }

package/ios/ExpoBeaconModule.swift

@@ -13,19 +13,19 @@ 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"
+private let EXIT_TIMEOUT_SECONDS_KEY = "expo.beacon.exit_timeout_seconds"
 
 /// Default minimum RSSI (dBm) below which beacon readings are discarded as unreliable.
 private let DEFAULT_MIN_RSSI: Int = -85
+/// Default seconds of silence after last beacon sighting before a disappearance-based exit fires.
+private let DEFAULT_EXIT_TIMEOUT_SECONDS: TimeInterval = 300.0
 
-/// Number of consecutive ranging misses before emitting a distance-based exit event.
-/// With ~1 s CoreLocation ranging cycles (iBeacon) or ~2 s Eddystone monitoring ticks,
-/// 20 misses ≈ 20–40 s of silence before declaring exit — tolerant of iOS background
-/// BLE throttling while still responsive to actual departures.
-/// NOTE: Android uses 10 with a ~2.1 s scan cycle (≈21 s effective).
-private let EXIT_MISS_THRESHOLD = 20
-/// Number of consecutive readings required to confirm a distance-based enter or exit transition.
+/// Number of consecutive in-range readings required before an enter event is emitted.
 /// IMPORTANT: Keep in sync with BeaconConstants.kt (Android).
-private let HYSTERESIS_COUNT = 3
+private let ENTER_HYSTERESIS_COUNT = 1
+/// Number of consecutive out-of-range readings required before an exit event is emitted.
+/// IMPORTANT: Keep in sync with BeaconConstants.kt (Android).
+private let EXIT_HYSTERESIS_COUNT = 3
 
 /// Eddystone monitoring timer interval in seconds.
 private let EDDYSTONE_MONITORING_TICK_INTERVAL: TimeInterval = 2.0
@@ -67,8 +67,10 @@ public class ExpoBeaconModule: Module {
     private var distanceRangingConstraints: [String: CLBeaconIdentityConstraint] = [:]
     // Identifiers currently in "entered" state (used for distance-driven enter/exit)
     private var enteredRegions: Set<String> = []
-    // Consecutive miss counter per identifier (for distance-based exit when beacon disappears)
+    // Consecutive miss counter per identifier (for tracking silence; exit now time-based)
     private var missCounters: [String: Int] = [:]
+    // Per-identifier timestamp of the last valid ranging reading (for time-based exit detection)
+    private var lastSeenTimes: [String: Date] = [:]
     // Hysteresis counters: consecutive readings inside/outside threshold per identifier
     private var enterCounters: [String: Int] = [:]
     private var exitCounters: [String: Int] = [:]
@@ -105,6 +107,9 @@ public class ExpoBeaconModule: Module {
     /// Event level: "all" emits distance + enter/exit/timeout; "events" suppresses distance.
     private var eventLevel: String = "all"
 
+    /// Seconds of silence after last valid beacon sighting before a miss-based exit fires.
+    private var exitTimeoutSeconds: TimeInterval = DEFAULT_EXIT_TIMEOUT_SECONDS
+
     /// Distance smoothing (EMA) state per identifier.
     private var smoothedDistances: [String: Double] = [:]
     /// EMA weight for new readings. 0.4 balances responsiveness vs noise rejection.
@@ -342,12 +347,14 @@ public class ExpoBeaconModule: Module {
             var maxDistance: Double? = nil
             var exitDistance: Double? = nil
             var minRssi: Int? = nil
+            var exitTimeoutSecs: Double? = nil
             if let dist: Double = options?.get() {
                 maxDistance = dist
             } else if let map: [String: Any] = options?.get() {
                 maxDistance = map["maxDistance"] as? Double
                 exitDistance = map["exitDistance"] as? Double
                 minRssi = map["minRssi"] as? Int
+                exitTimeoutSecs = map["exitTimeoutSeconds"] as? Double
                 if let lvl = map["level"] as? String, lvl == "events" || lvl == "all" {
                     self.eventLevel = lvl
                     self.defaults.set(lvl, forKey: EVENT_LEVEL_KEY)
@@ -381,6 +388,11 @@ public class ExpoBeaconModule: Module {
                 self.sendLoggedEvent("onBeaconError", ["identifier": "", "code": "INVALID_EXIT_DISTANCE", "message": "exitDistance must be greater than or equal to maxDistance"])
                 return
             }
+            if let t = exitTimeoutSecs, (!t.isFinite || t <= 0) {
+                promise.reject("INVALID_EXIT_TIMEOUT", "exitTimeoutSeconds must be a finite number greater than 0")
+                self.sendLoggedEvent("onBeaconError", ["identifier": "", "code": "INVALID_EXIT_TIMEOUT", "message": "exitTimeoutSeconds must be a finite number greater than 0"])
+                return
+            }
             if let dist = maxDistance {
                 self.defaults.set(dist, forKey: MAX_DISTANCE_KEY)
             } else {
@@ -398,6 +410,13 @@ public class ExpoBeaconModule: Module {
                 self.defaults.removeObject(forKey: MIN_RSSI_KEY)
                 self.minRssiThreshold = DEFAULT_MIN_RSSI
             }
+            if let t = exitTimeoutSecs {
+                self.defaults.set(t, forKey: EXIT_TIMEOUT_SECONDS_KEY)
+                self.exitTimeoutSeconds = t
+            } else {
+                self.defaults.removeObject(forKey: EXIT_TIMEOUT_SECONDS_KEY)
+                self.exitTimeoutSeconds = DEFAULT_EXIT_TIMEOUT_SECONDS
+            }
             self.defaults.set(true, forKey: IS_MONITORING_KEY)
             self.requestLocationPermission { granted in
                 guard granted else {
@@ -422,7 +441,10 @@ public class ExpoBeaconModule: Module {
             self.defaults.removeObject(forKey: MAX_DISTANCE_KEY)
             self.defaults.removeObject(forKey: EXIT_DISTANCE_KEY)
             self.defaults.removeObject(forKey: EVENT_LEVEL_KEY)
+            self.defaults.removeObject(forKey: EXIT_TIMEOUT_SECONDS_KEY)
             self.eventLevel = "all"
+            self.exitTimeoutSeconds = DEFAULT_EXIT_TIMEOUT_SECONDS
+            self.lastSeenTimes.removeAll()
             self.stopRegionMonitoring()
             promise.resolve(nil)
         }
@@ -541,6 +563,9 @@ public class ExpoBeaconModule: Module {
             if let level = self.defaults.string(forKey: EVENT_LEVEL_KEY) {
                 result["level"] = level
             }
+            if let t = self.defaults.object(forKey: EXIT_TIMEOUT_SECONDS_KEY) as? Double {
+                result["exitTimeoutSeconds"] = t
+            }
             if let json = self.defaults.string(forKey: NOTIFICATION_CONFIG_KEY),
                let data = json.data(using: .utf8),
                let obj = try? JSONSerialization.jsonObject(with: data) as? [String: Any] {
@@ -647,6 +672,13 @@ public class ExpoBeaconModule: Module {
         // Restore persisted event level (survives app restarts)
         eventLevel = defaults.string(forKey: EVENT_LEVEL_KEY) ?? "all"
 
+        // Restore persisted exit timeout (survives app restarts)
+        if let t = defaults.object(forKey: EXIT_TIMEOUT_SECONDS_KEY) as? Double, t > 0 {
+            exitTimeoutSeconds = t
+        } else {
+            exitTimeoutSeconds = DEFAULT_EXIT_TIMEOUT_SECONDS
+        }
+
         let beacons = loadPairedBeaconsRaw()
 
         // CLLocationManager supports a maximum of 20 monitored regions.
@@ -708,6 +740,7 @@ public class ExpoBeaconModule: Module {
         distanceRangingConstraints.removeAll()
         enteredRegions.removeAll()
         missCounters.removeAll()
+        lastSeenTimes.removeAll()
         enterCounters.removeAll()
         exitCounters.removeAll()
         smoothedDistances.removeAll()
@@ -1066,6 +1099,14 @@ public class ExpoBeaconModule: Module {
                 minor: params["minor"] as? Int ?? 0,
                 distance: distance
             )
+        case "onBeaconTimeout":
+            r.dispatchBeaconTimeout(
+                identifier: identifier,
+                uuid: params["uuid"] as? String ?? "",
+                major: params["major"] as? Int ?? 0,
+                minor: params["minor"] as? Int ?? 0,
+                distance: distance
+            )
         case "onEddystoneEnter":
             r.dispatchEddystoneEnter(
                 identifier: identifier,
@@ -1080,6 +1121,13 @@ public class ExpoBeaconModule: Module {
                 instance: params["instance"] as? String ?? "",
                 distance: distance
             )
+        case "onEddystoneTimeout":
+            r.dispatchEddystoneTimeout(
+                identifier: identifier,
+                namespace: params["namespace"] as? String ?? "",
+                instance: params["instance"] as? String ?? "",
+                distance: distance
+            )
         default:
             break
         }
@@ -1246,14 +1294,23 @@ public class ExpoBeaconModule: Module {
 
             // Not seen recently — reset exit counter (miss counter handles exit
             // separately) but preserve enter counter so that background BLE
-            // throttling gaps don't force re-accumulating HYSTERESIS_COUNT reads.
+            // throttling gaps don't force re-accumulating ENTER_HYSTERESIS_COUNT reads.
             eddystoneExitCounters[identifier] = 0
             guard eddystoneEnteredRegions.contains(identifier) else { continue }
 
             let count = (eddystoneMissCounters[identifier] ?? 0) + 1
             eddystoneMissCounters[identifier] = count
 
-            if count >= EXIT_MISS_THRESHOLD {
+            // Fire exit only after silence exceeds the configured exitTimeoutSeconds.
+            // eddystoneLatestSeen already tracks Date of last sighting for this identifier.
+            let silentLongEnough: Bool
+            if let lastSeen = eddystoneLatestSeen[identifier] {
+                silentLongEnough = now.timeIntervalSince(lastSeen) >= exitTimeoutSeconds
+            } else {
+                silentLongEnough = false
+            }
+
+            if silentLongEnough {
                 eddystoneEnteredRegions.remove(identifier)
                 eddystoneMissCounters[identifier] = 0
                 eddystoneEnterCounters[identifier] = 0
@@ -1477,7 +1534,7 @@ public class ExpoBeaconModule: Module {
             if distance <= maxDist {
                 exitCtrs[identifier] = 0
                 enterCtrs[identifier] = (enterCtrs[identifier] ?? 0) + 1
-                if !entered.contains(identifier) && (enterCtrs[identifier] ?? 0) >= HYSTERESIS_COUNT {
+                if !entered.contains(identifier) && (enterCtrs[identifier] ?? 0) >= ENTER_HYSTERESIS_COUNT {
                     entered.insert(identifier)
                     enterCtrs[identifier] = 0
                     return .enter
@@ -1485,7 +1542,7 @@ public class ExpoBeaconModule: Module {
             } else if distance > exitDist {
                 enterCtrs[identifier] = 0
                 exitCtrs[identifier] = (exitCtrs[identifier] ?? 0) + 1
-                if entered.contains(identifier) && (exitCtrs[identifier] ?? 0) >= HYSTERESIS_COUNT {
+                if entered.contains(identifier) && (exitCtrs[identifier] ?? 0) >= EXIT_HYSTERESIS_COUNT {
                     entered.remove(identifier)
                     exitCtrs[identifier] = 0
                     return .exit
@@ -1497,7 +1554,7 @@ public class ExpoBeaconModule: Module {
             }
         } else {
             enterCtrs[identifier] = (enterCtrs[identifier] ?? 0) + 1
-            if !entered.contains(identifier) && (enterCtrs[identifier] ?? 0) >= HYSTERESIS_COUNT {
+            if !entered.contains(identifier) && (enterCtrs[identifier] ?? 0) >= ENTER_HYSTERESIS_COUNT {
                 entered.insert(identifier)
                 enterCtrs[identifier] = 0
                 return .enter
@@ -1559,8 +1616,9 @@ public class ExpoBeaconModule: Module {
             let validBeacon = beacons.first(where: { $0.accuracy >= 0 && $0.rssi >= minRssiThreshold })
 
             if let beacon = validBeacon {
-                // Got a valid reading — reset miss counter
+                // Got a valid reading — reset miss counter and record sighting time
                 missCounters[identifier] = 0
+                lastSeenTimes[identifier] = Date()
                 // Valid BLE reading — reset inactivity timer.
                 rescheduleBeaconInactivity(identifier: identifier, beacon: beacon)
 
@@ -1572,7 +1630,7 @@ public class ExpoBeaconModule: Module {
                 // Enter/exit synthesis with hysteresis — always applied.
                 // When maxDistance is set, distance thresholds control transitions.
                 // When maxDistance is nil, pure presence-based hysteresis is used
-                // (HYSTERESIS_COUNT consecutive readings to confirm enter).
+                // (ENTER_HYSTERESIS_COUNT consecutive readings to confirm enter).
                 let maxDist = self.defaults.object(forKey: MAX_DISTANCE_KEY) as? Double
                 let exitDist = self.defaults.object(forKey: EXIT_DISTANCE_KEY) as? Double
 
@@ -1611,16 +1669,19 @@ public class ExpoBeaconModule: Module {
             } else {
                 // No valid beacon reading — beacon may have disappeared.
                 // Preserve enter counter so background accuracy=-1 gaps don't
-                // force re-accumulating HYSTERESIS_COUNT reads from scratch.
+                // force re-accumulating ENTER_HYSTERESIS_COUNT reads from scratch.
                 exitCounters[identifier] = 0
                 let count = (missCounters[identifier] ?? 0) + 1
                 missCounters[identifier] = count
 
-                if enteredRegions.contains(identifier) && count >= EXIT_MISS_THRESHOLD {
+                if enteredRegions.contains(identifier),
+                   let lastSeen = lastSeenTimes[identifier],
+                   Date().timeIntervalSince(lastSeen) >= exitTimeoutSeconds {
                     enteredRegions.remove(identifier)
                     missCounters[identifier] = 0
                     enterCounters[identifier] = 0
                     exitCounters[identifier] = 0
+                    lastSeenTimes.removeValue(forKey: identifier)
                     smoothedDistances.removeValue(forKey: identifier)
 
                     // Look up region info for the exit event payload
@@ -1655,7 +1716,7 @@ public class ExpoBeaconModule: Module {
     fileprivate func handleDidEnterRegion(_ region: CLRegion) {
         // Region callbacks are suppressed — all enter/exit logic goes through
         // ranging-based hysteresis in handleDidRange for consistent behaviour
-        // with HYSTERESIS_COUNT, regardless of whether maxDistance is set.
+        // with ENTER_HYSTERESIS_COUNT / EXIT_HYSTERESIS_COUNT, regardless of whether maxDistance is set.
     }
 
     fileprivate func handleDidExitRegion(_ region: CLRegion) {

package/package.json

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

package/plugin/build/withBeaconAndroid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withBeaconAndroid.d.ts","sourceRoot":"","sources":["../src/withBeaconAndroid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAoB,MAAM,sBAAsB,CAAC;AAMtE,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA0BlE;AAqCD,QAAA,MAAM,iBAAiB,EAAE,YA0DxB,CAAC;AAEF,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"withBeaconAndroid.d.ts","sourceRoot":"","sources":["../src/withBeaconAndroid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAoB,MAAM,sBAAsB,CAAC;AAMtE,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA8BlE;AAqCD,QAAA,MAAM,iBAAiB,EAAE,YA0DxB,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/plugin/build/withBeaconAndroid.js

@@ -25,10 +25,14 @@ class BeaconGeoPlugin(ctx: Context) : BeaconEventPlugin {
         bgGeo.start(noOp)
     override fun onBeaconExit(identifier: String, uuid: String, major: Int, minor: Int, distance: Double) =
         bgGeo.stop(noOp)
+    override fun onBeaconTimeout(identifier: String, uuid: String, major: Int, minor: Int, distance: Double) =
+        bgGeo.stop(noOp)
     override fun onEddystoneEnter(identifier: String, namespace: String, instance: String, distance: Double) =
         bgGeo.start(noOp)
     override fun onEddystoneExit(identifier: String, namespace: String, instance: String, distance: Double) =
         bgGeo.stop(noOp)
+    override fun onEddystoneTimeout(identifier: String, namespace: String, instance: String, distance: Double) =
+        bgGeo.stop(noOp)
 }
 `;
 }

package/plugin/build/withBeaconIOS.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withBeaconIOS.d.ts","sourceRoot":"","sources":["../src/withBeaconIOS.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAsC,MAAM,sBAAsB,CAAC;AAMxF,wBAAgB,iBAAiB,IAAI,MAAM,CAoB1C;AA+ED,QAAA,MAAM,aAAa,EAAE,YAmEpB,CAAC;AAEF,eAAe,aAAa,CAAC"}
+{"version":3,"file":"withBeaconIOS.d.ts","sourceRoot":"","sources":["../src/withBeaconIOS.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAsC,MAAM,sBAAsB,CAAC;AAMxF,wBAAgB,iBAAiB,IAAI,MAAM,CA0B1C;AA+ED,QAAA,MAAM,aAAa,EAAE,YAmEpB,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/plugin/build/withBeaconIOS.js

@@ -17,12 +17,18 @@ final class BeaconGeoPlugin: BeaconLifecycleDelegate {
     func beaconDidExit(identifier: String, uuid: String, major: Int, minor: Int, distance: Double) {
         BackgroundGeolocation.sharedInstance().stop()
     }
+    func beaconDidTimeout(identifier: String, uuid: String, major: Int, minor: Int, distance: Double) {
+        BackgroundGeolocation.sharedInstance().stop()
+    }
     func eddystoneDidEnter(identifier: String, namespace: String, instance: String, distance: Double) {
         BackgroundGeolocation.sharedInstance().start()
     }
     func eddystoneDidExit(identifier: String, namespace: String, instance: String, distance: Double) {
         BackgroundGeolocation.sharedInstance().stop()
     }
+    func eddystoneDidTimeout(identifier: String, namespace: String, instance: String, distance: Double) {
+        BackgroundGeolocation.sharedInstance().stop()
+    }
 }
 `;
 }

package/src/ExpoBeacon.types.ts

@@ -130,6 +130,8 @@ export type MonitoringConfig = {
   exitDistance?: number;
   minRssi?: number;
   level?: 'all' | 'events';
+  /** Seconds after last beacon sighting before an exit event fires. Default: 300. */
+  exitTimeoutSeconds?: number;
   notifications?: NotificationConfig;
 };
 
@@ -186,6 +188,13 @@ export type MonitoringOptions = {
    * - `'events'`: enter + exit + timeout only (no distance events).
    */
   level?: 'all' | 'events';
+  /**
+   * Seconds after last beacon sighting before an exit event fires when the beacon
+   * disappears without moving outside the exit distance threshold.
+   *
+   * Default: 300 (5 minutes). Minimum: 1.
+   */
+  exitTimeoutSeconds?: number;
   /** Notification configuration overrides to apply for this monitoring session. */
   notifications?: NotificationConfig;
 };