expo-beacon 0.6.8 → 0.6.10

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

@@ -0,0 +1,101 @@
+package expo.modules.beacon
+
+import android.content.Context
+import android.content.SharedPreferences
+import android.os.Build
+import android.util.Log
+import org.json.JSONObject
+import java.io.OutputStreamWriter
+import java.net.HttpURLConnection
+import java.net.URL
+import java.util.concurrent.Executors
+
+private const val API_PREFS = "expo.beacon.api_config"
+private const val API_URL_KEY = "api_url"
+private const val API_KEY_KEY = "api_key"
+private const val MAX_RETRIES = 3
+
+/**
+ * Fire-and-forget HTTP event forwarder for beacon events.
+ * Sends enter/exit/timeout events to a configured API endpoint from native code,
+ * ensuring delivery even when the JS bridge is not active (app backgrounded).
+ */
+internal class BeaconApiForwarder(private val context: Context) {
+
+    private val executor = Executors.newSingleThreadExecutor()
+    private val prefs: SharedPreferences by lazy {
+        context.getSharedPreferences(API_PREFS, Context.MODE_PRIVATE)
+    }
+
+    val isConfigured: Boolean
+        get() = prefs.getString(API_URL_KEY, null)?.isNotEmpty() == true
+
+    fun configure(url: String, apiKey: String?) {
+        prefs.edit().apply {
+            putString(API_URL_KEY, url)
+            if (apiKey != null) putString(API_KEY_KEY, apiKey)
+            else remove(API_KEY_KEY)
+        }.apply()
+    }
+
+    fun getConfig(): Map<String, String?> {
+        return mapOf(
+            "url" to prefs.getString(API_URL_KEY, null),
+            "apiKey" to prefs.getString(API_KEY_KEY, null)
+        )
+    }
+
+    /**
+     * Send a beacon event to the configured API endpoint.
+     * Fire-and-forget with simple retry (3 attempts, exponential backoff).
+     * No-op if no endpoint is configured.
+     */
+    fun forwardEvent(params: Map<String, Any?>) {
+        val url = prefs.getString(API_URL_KEY, null)
+        if (url.isNullOrEmpty()) return
+
+        val apiKey = prefs.getString(API_KEY_KEY, null)
+        val payload = JSONObject().apply {
+            for ((k, v) in params) {
+                put(k, v ?: JSONObject.NULL)
+            }
+            put("timestamp", System.currentTimeMillis())
+            put("platform", "android")
+            put("sdkVersion", Build.VERSION.SDK_INT)
+        }
+
+        executor.execute {
+            var lastException: Exception? = null
+            for (attempt in 1..MAX_RETRIES) {
+                try {
+                    val conn = URL(url).openConnection() as HttpURLConnection
+                    conn.apply {
+                        requestMethod = "POST"
+                        setRequestProperty("Content-Type", "application/json")
+                        apiKey?.let { setRequestProperty("X-API-Key", it) }
+                        connectTimeout = 10_000
+                        readTimeout = 10_000
+                        doOutput = true
+                    }
+                    OutputStreamWriter(conn.outputStream, Charsets.UTF_8).use { it.write(payload.toString()) }
+                    val code = conn.responseCode
+                    conn.disconnect()
+                    if (code in 200..299) return@execute
+                    // 4xx client errors — don't retry
+                    if (code in 400..499) {
+                        Log.w(TAG, "API forward failed with $code — not retrying")
+                        return@execute
+                    }
+                    lastException = RuntimeException("HTTP $code")
+                } catch (e: Exception) {
+                    lastException = e
+                }
+                // Exponential backoff: 1s, 2s, 4s
+                if (attempt < MAX_RETRIES) {
+                    try { Thread.sleep(1000L * (1 shl (attempt - 1))) } catch (_: InterruptedException) {}
+                }
+            }
+            Log.w(TAG, "API forward failed after $MAX_RETRIES attempts: ${lastException?.message}")
+        }
+    }
+}

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

@@ -47,6 +47,9 @@ internal const val HYSTERESIS_COUNT = 3
  */
 internal const val REGION_EXIT_PERIOD_MS = 60000L
 
+/** Default minimum RSSI (dBm) below which beacon readings are discarded as unreliable. */
+internal const val DEFAULT_MIN_RSSI = -85
+
 /** Shared log tag for the expo-beacon module. */
 internal const val TAG = "ExpoBeacon"
 

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

@@ -24,6 +24,7 @@ class BeaconEventReceiver(
         val eventType = intent.getStringExtra("event") ?: return
         val beaconType = intent.getStringExtra("beaconType") ?: "ibeacon"
         val distance = intent.getDoubleExtra("distance", -1.0)
+        val rssi = intent.getIntExtra("rssi", 0)
 
         if (beaconType == "eddystone") {
             val namespace = intent.getStringExtra("namespace") ?: ""
@@ -34,7 +35,8 @@ class BeaconEventReceiver(
                 "namespace" to namespace,
                 "instance" to instance,
                 "event" to eventType,
-                "distance" to distance
+                "distance" to distance,
+                "rssi" to rssi
             )
 
             val eventName = when (eventType) {
@@ -56,7 +58,8 @@ class BeaconEventReceiver(
                 "major" to major,
                 "minor" to minor,
                 "event" to eventType,
-                "distance" to distance
+                "distance" to distance,
+                "rssi" to rssi
             )
 
             val eventName = when (eventType) {

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

@@ -38,6 +38,7 @@ class BeaconForegroundService : Service(), BeaconConsumer {
     // Distance filtering
     @Volatile private var maxDistance: Double? = null
     @Volatile private var exitDistance: Double? = null
+    @Volatile private var minRssiThreshold: Int = DEFAULT_MIN_RSSI
     private val monitoredRegionIds = java.util.concurrent.CopyOnWriteArraySet<String>()
     private val enteredRegions = java.util.concurrent.CopyOnWriteArraySet<String>()
     private val lastSeenAtMs = java.util.concurrent.ConcurrentHashMap<String, Long>()
@@ -48,6 +49,9 @@ class BeaconForegroundService : Service(), BeaconConsumer {
     private val exitCounters = java.util.concurrent.ConcurrentHashMap<String, Int>()
     private val missCounters = java.util.concurrent.ConcurrentHashMap<String, Int>()
 
+    // Distance smoothing (EMA)
+    private val smoothedDistances = java.util.concurrent.ConcurrentHashMap<String, Double>()
+
     // Notification ID counter for unique per-beacon notifications
     private val notifIdCounter = AtomicInteger(0)
     private val notifIdMap = java.util.concurrent.ConcurrentHashMap<String, Int>()
@@ -61,10 +65,12 @@ class BeaconForegroundService : Service(), BeaconConsumer {
     // Per-beacon timeout seconds lookup (identifier → seconds), loaded from paired data
     private val beaconTimeouts = java.util.concurrent.ConcurrentHashMap<String, Int>()
     private var eventLogger: BeaconEventLogger? = null
+    private var apiForwarder: BeaconApiForwarder? = null
 
     override fun onCreate() {
         super.onCreate()
         createNotificationChannel()
+        apiForwarder = BeaconApiForwarder(this)
         beaconManager = BeaconManager.getInstanceForApplication(this).also { manager ->
             BeaconParsers.ensureRegistered(manager)
             try { manager.setEnableScheduledScanJobs(false) } catch (e: IllegalStateException) { Log.w(TAG, "setEnableScheduledScanJobs failed", e) }
@@ -114,10 +120,11 @@ class BeaconForegroundService : Service(), BeaconConsumer {
 
     override fun onBeaconServiceConnect() {
         serviceConnected = true
-        // Read max distance and exit distance from options prefs
+        // Read max distance, exit distance, and min RSSI from options prefs
         val optPrefs = getSharedPreferences(MONITORING_OPTIONS_PREFS, Context.MODE_PRIVATE)
         maxDistance = optPrefs.getString("max_distance", null)?.toDoubleOrNull()
         exitDistance = optPrefs.getString("exit_distance", null)?.toDoubleOrNull()
+        minRssiThreshold = optPrefs.getInt("min_rssi", DEFAULT_MIN_RSSI)
 
         beaconManager.addMonitorNotifier(monitorNotifier)
         beaconManager.addRangeNotifier(rangeNotifier)
@@ -171,6 +178,7 @@ class BeaconForegroundService : Service(), BeaconConsumer {
             enterCounters.clear()
             exitCounters.clear()
             missCounters.clear()
+            smoothedDistances.clear()
         }
         // NOTE: enteredRegions is intentionally NOT cleared here.
         // Clearing it on every reload (e.g. START_STICKY restart or repeated
@@ -249,10 +257,10 @@ class BeaconForegroundService : Service(), BeaconConsumer {
     // Distance logging only — emits distance broadcasts. Enter/exit logic lives in rangeNotifier.
     private val distanceLoggingRangeNotifier = RangeNotifier { beacons, region ->
         if (!monitoredRegionIds.contains(region.uniqueId)) return@RangeNotifier
-        val closest = beacons.filter { it.distance >= 0 }.minByOrNull { it.distance }
+        val closest = beacons.filter { it.distance >= 0 && it.rssi >= minRssiThreshold }.minByOrNull { it.distance }
         if (closest != null) {
             lastSeenAtMs[region.uniqueId] = SystemClock.elapsedRealtime()
-            sendBeaconBroadcast(region, "distance", closest.distance)
+            sendBeaconBroadcast(region, "distance", closest.distance, closest.rssi)
         }
     }
 
@@ -299,7 +307,7 @@ class BeaconForegroundService : Service(), BeaconConsumer {
         if (!monitoredRegionIds.contains(region.uniqueId)) return@RangeNotifier
 
         val beacon = beacons
-            .filter { it.distance >= 0 }
+            .filter { it.distance >= 0 && it.rssi >= minRssiThreshold }
             .minByOrNull { it.distance }
 
         synchronized(distanceLock) {
@@ -308,18 +316,25 @@ class BeaconForegroundService : Service(), BeaconConsumer {
                 lastSeenAtMs[region.uniqueId] = SystemClock.elapsedRealtime()
                 missCounters[region.uniqueId] = 0
 
-                val action = evaluateDistanceHysteresis(region.uniqueId, beacon.distance, maxDist)
+                // Apply EMA smoothing; jump guard returns null for outliers
+                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) {
                     HysteresisAction.ENTER -> {
                         enteredRegions.add(region.uniqueId)
-                        sendBeaconBroadcast(region, "enter", beacon.distance)
+                        sendBeaconBroadcast(region, "enter", beacon.distance, beacon.rssi)
                         showEnterExitNotification(region, "enter")
                         scheduleTimeoutIfConfigured(region)
                     }
                     HysteresisAction.EXIT -> {
                         cancelTimeout(region.uniqueId)
                         enteredRegions.remove(region.uniqueId)
-                        sendBeaconBroadcast(region, "exit", beacon.distance)
+                        sendBeaconBroadcast(region, "exit", beacon.distance, beacon.rssi)
                         showEnterExitNotification(region, "exit")
                     }
                     HysteresisAction.NONE -> {}
@@ -333,7 +348,12 @@ class BeaconForegroundService : Service(), BeaconConsumer {
                 missCounters[region.uniqueId] = count
 
                 if (enteredRegions.contains(region.uniqueId) && count >= EXIT_MISS_THRESHOLD) {
-                    cancelTimeout(region.uniqueId)
+                    // Do NOT cancel the timeout here. A miss-based exit is triggered by BLE
+                    // scan gaps (unreliable signal disappearance), not a confirmed physical
+                    // departure. Cancelling the timeout here would prevent it from ever firing
+                    // when the configured timeout (e.g. 25 s) exceeds the miss window (~21 s).
+                    // The timeout runnable fires unconditionally; distance-based exits still
+                    // call cancelTimeout() reliably when the beacon moves out of range.
                     enteredRegions.remove(region.uniqueId)
                     missCounters[region.uniqueId] = 0
                     enterCounters[region.uniqueId] = 0
@@ -349,6 +369,26 @@ class BeaconForegroundService : Service(), BeaconConsumer {
 
     private enum class HysteresisAction { NONE, ENTER, EXIT }
 
+    /**
+     * 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).
+     */
+    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
+        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
+        }
+        val smoothed = DISTANCE_EMA_ALPHA * rawDistance + (1 - DISTANCE_EMA_ALPHA) * prev
+        smoothedDistances[regionId] = smoothed
+        return smoothed
+    }
+
     /**
      * Computes the effective exit distance from maxDistance and an optional explicit exitDistance.
      * Default: maxDistance + min(maxDistance × 0.5, 2.5).
@@ -423,10 +463,11 @@ class BeaconForegroundService : Service(), BeaconConsumer {
         cancelTimeout(region.uniqueId)
         val runnable = Runnable {
             timeoutRunnables.remove(region.uniqueId)
-            // Only fire if the beacon is still in range
-            if (enteredRegions.contains(region.uniqueId)) {
-                sendBeaconBroadcast(region, "timeout", -1.0)
-            }
+            // Fire unconditionally. A miss-based exit may have cleared enteredRegions before
+            // the timer elapsed (BLE gaps can cause false exits at ~21 s), but the beacon
+            // may still be physically present. Distance-based exits call cancelTimeout() so
+            // this runnable is never queued when the beacon has genuinely moved away.
+            sendBeaconBroadcast(region, "timeout", -1.0)
         }
         timeoutRunnables[region.uniqueId] = runnable
         timeoutHandler.postDelayed(runnable, seconds * 1000L)
@@ -436,7 +477,7 @@ class BeaconForegroundService : Service(), BeaconConsumer {
         timeoutRunnables.remove(regionId)?.let { timeoutHandler.removeCallbacks(it) }
     }
 
-    private fun sendBeaconBroadcast(region: Region, eventType: String, distance: Double) {
+    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)
         val id1Str = region.id1?.toString() ?: ""
@@ -449,6 +490,7 @@ class BeaconForegroundService : Service(), BeaconConsumer {
                 put("instance", region.id2?.toString()?.removePrefix("0x") ?: "")
                 put("event", eventType)
                 put("distance", distance)
+                put("rssi", rssi)
             }
         } else {
             buildMap<String, Any?> {
@@ -458,14 +500,21 @@ class BeaconForegroundService : Service(), BeaconConsumer {
                 put("minor", region.id3?.toInt() ?: 0)
                 put("event", eventType)
                 put("distance", distance)
+                put("rssi", rssi)
             }
         }
         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)
+        }
+
         val intent = Intent(ACTION_BEACON_EVENT).apply {
             putExtra("identifier", region.uniqueId)
             putExtra("event", eventType)
             putExtra("distance", distance)
+            putExtra("rssi", rssi)
             if (isEddystone) {
                 putExtra("beaconType", "eddystone")
                 putExtra("namespace", id1Str.removePrefix("0x"))
@@ -587,6 +636,11 @@ class BeaconForegroundService : Service(), BeaconConsumer {
     }
 
     companion object {
+        /** EMA weight for new readings. 0.4 balances responsiveness vs noise rejection. */
+        const val DISTANCE_EMA_ALPHA = 0.4
+        /** If raw distance differs from smoothed by more than this factor, treat as outlier. */
+        const val DISTANCE_JUMP_FACTOR = 5.0
+
         private const val PREF_IS_MONITORING = "expo.beacon.is_monitoring"
 
         fun start(context: Context) {

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

@@ -281,6 +281,7 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
             }
             var maxDistance: Double? = null
             var exitDistance: Double? = null
+            var minRssi: Int? = null
             when (options) {
                 is Double -> maxDistance = options
                 is Map<*, *> -> {
@@ -288,6 +289,7 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
                     val map = options as Map<String, Any?>
                     maxDistance = (map["maxDistance"] as? Number)?.toDouble()
                     exitDistance = (map["exitDistance"] as? Number)?.toDouble()
+                    minRssi = (map["minRssi"] as? Number)?.toInt()
                     val notifications = map["notifications"]
                     if (notifications is Map<*, *>) {
                         @Suppress("UNCHECKED_CAST")
@@ -318,6 +320,8 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
                     else remove("max_distance")
                     if (exitDistance != null) putString("exit_distance", exitDistance.toString())
                     else remove("exit_distance")
+                    if (minRssi != null) putInt("min_rssi", minRssi)
+                    else remove("min_rssi")
                 }.apply()
             // Verify we have the permissions needed for background monitoring
             val hasLocation = ContextCompat.checkSelfPermission(ctx, Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED
@@ -449,6 +453,14 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
             BeaconEventLogger.deleteLogDatabase(ctx)
         }
 
+        // MARK: - API Forwarding
+
+        Function("setApiEndpoint") { url: String, apiKey: String? ->
+            val ctx = appContext.reactContext
+                ?: throw IllegalStateException("React context is not available")
+            BeaconApiForwarder(ctx).configure(url, apiKey)
+        }
+
         // MARK: - Battery Optimization
 
         Function("isBatteryOptimizationExempt") {

package/build/ExpoBeacon.types.d.ts

@@ -38,6 +38,8 @@ export type BeaconRegionEvent = {
     event: "enter" | "exit";
     /** Measured distance in metres at the time of the event (–1 if unavailable). */
     distance: number;
+    /** Signal strength in dBm at the time of the event (0 if unavailable). */
+    rssi?: number;
 };
 /** Payload for periodic distance update events during monitoring. */
 export type BeaconDistanceEvent = {
@@ -46,6 +48,8 @@ export type BeaconDistanceEvent = {
     major: number;
     minor: number;
     distance: number;
+    /** Signal strength in dBm (0 if unavailable). */
+    rssi?: number;
 };
 /** Payload for beacon timeout events (beacon in range for configured duration). */
 export type BeaconTimeoutEvent = {
@@ -120,6 +124,14 @@ export type MonitoringOptions = {
      * Only used when `maxDistance` is set.
      */
     exitDistance?: number;
+    /**
+     * Minimum RSSI (dBm) for a beacon reading to be considered valid.
+     * Readings below this threshold are discarded as unreliable, preventing
+     * false detections from reflected or distant signals.
+     *
+     * Default: -85. Typical range: -100 (very permissive) to -70 (strict).
+     */
+    minRssi?: number;
     /** Notification configuration overrides to apply for this monitoring session. */
     notifications?: NotificationConfig;
 };
@@ -169,6 +181,8 @@ export type EddystoneRegionEvent = {
     event: "enter" | "exit";
     /** Measured distance in metres at the time of the event (–1 if unavailable). */
     distance: number;
+    /** Signal strength in dBm at the time of the event (0 if unavailable). */
+    rssi?: number;
 };
 /** Payload for periodic Eddystone distance update events during monitoring. */
 export type EddystoneDistanceEvent = {
@@ -176,6 +190,8 @@ export type EddystoneDistanceEvent = {
     namespace: string;
     instance: string;
     distance: number;
+    /** Signal strength in dBm (0 if unavailable). */
+    rssi?: number;
 };
 /** Payload for Eddystone timeout events (beacon in range for configured duration). */
 export type EddystoneTimeoutEvent = {

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};\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};\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  /** 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};\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};\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  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"]}

package/build/ExpoBeaconModule.d.ts

@@ -102,6 +102,15 @@ declare class ExpoBeaconModule extends NativeModule<ExpoBeaconModuleEvents> {
     clearEventLogs(): void;
     /** Delete the entire event log database. Also disables logging. */
     destroyEventLogs(): void;
+    /**
+     * Configure a remote API endpoint for native event forwarding.
+     * Once set, enter/exit/timeout 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.
+     * @param apiKey Optional API key sent as X-API-Key header.
+     */
+    setApiEndpoint(url: string, apiKey?: string): void;
 }
 declare const _default: ExpoBeaconModule;
 export default _default;

package/build/ExpoBeaconModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoBeaconModule.d.ts","sourceRoot":"","sources":["../src/ExpoBeaconModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,MAAM,CAAC;AAEzD,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACd,MAAM,oBAAoB,CAAC;AAE5B,OAAO,OAAO,gBAAiB,SAAQ,YAAY,CAAC,sBAAsB,CAAC;IACzE;;;;;;;;;;;OAWG;IACH,mBAAmB,CACjB,KAAK,CAAC,EAAE,MAAM,EAAE,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAE9B;;;;;OAKG;IACH,sBAAsB,CACpB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAEjC;;OAEG;IACH,UAAU,CACR,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,MAAM,GACtB,IAAI;IAEP;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAEtC;;OAEG;IACH,gBAAgB,IAAI,YAAY,EAAE;IAElC;;OAEG;IACH,aAAa,CACX,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,MAAM,GACtB,IAAI;IAEP;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAEzC;;OAEG;IACH,mBAAmB,IAAI,eAAe,EAAE;IAExC;;;OAGG;IACH,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAEvD;;;;;;;OAOG;IACH,eAAe,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAEpE;;OAEG;IACH,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAE/B;;;OAGG;IACH,mBAAmB,IAAI,IAAI;IAE3B,iEAAiE;IACjE,kBAAkB,IAAI,IAAI;IAE1B;;;OAGG;IACH,UAAU,IAAI,IAAI;IAElB,yEAAyE;IACzE,uBAAuB,IAAI,OAAO,CAAC,OAAO,CAAC;IAE3C;;;OAGG;IACH,2BAA2B,IAAI,OAAO;IAEtC;;;;;OAKG;IACH,mCAAmC,IAAI,OAAO,CAAC,OAAO,CAAC;IAEvD,4FAA4F;IAC5F,kBAAkB,IAAI,IAAI;IAE1B,oEAAoE;IACpE,mBAAmB,IAAI,IAAI;IAE3B;;;OAGG;IACH,YAAY,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,aAAa,EAAE;IAE7D,kDAAkD;IAClD,cAAc,IAAI,IAAI;IAEtB,mEAAmE;IACnE,gBAAgB,IAAI,IAAI;CACzB;;AAED,wBAAmE"}
+{"version":3,"file":"ExpoBeaconModule.d.ts","sourceRoot":"","sources":["../src/ExpoBeaconModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,MAAM,CAAC;AAEzD,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACd,MAAM,oBAAoB,CAAC;AAE5B,OAAO,OAAO,gBAAiB,SAAQ,YAAY,CAAC,sBAAsB,CAAC;IACzE;;;;;;;;;;;OAWG;IACH,mBAAmB,CACjB,KAAK,CAAC,EAAE,MAAM,EAAE,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAE9B;;;;;OAKG;IACH,sBAAsB,CACpB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAEjC;;OAEG;IACH,UAAU,CACR,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,MAAM,GACtB,IAAI;IAEP;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAEtC;;OAEG;IACH,gBAAgB,IAAI,YAAY,EAAE;IAElC;;OAEG;IACH,aAAa,CACX,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,MAAM,GACtB,IAAI;IAEP;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAEzC;;OAEG;IACH,mBAAmB,IAAI,eAAe,EAAE;IAExC;;;OAGG;IACH,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAEvD;;;;;;;OAOG;IACH,eAAe,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAEpE;;OAEG;IACH,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAE/B;;;OAGG;IACH,mBAAmB,IAAI,IAAI;IAE3B,iEAAiE;IACjE,kBAAkB,IAAI,IAAI;IAE1B;;;OAGG;IACH,UAAU,IAAI,IAAI;IAElB,yEAAyE;IACzE,uBAAuB,IAAI,OAAO,CAAC,OAAO,CAAC;IAE3C;;;OAGG;IACH,2BAA2B,IAAI,OAAO;IAEtC;;;;;OAKG;IACH,mCAAmC,IAAI,OAAO,CAAC,OAAO,CAAC;IAEvD,4FAA4F;IAC5F,kBAAkB,IAAI,IAAI;IAE1B,oEAAoE;IACpE,mBAAmB,IAAI,IAAI;IAE3B;;;OAGG;IACH,YAAY,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,aAAa,EAAE;IAE7D,kDAAkD;IAClD,cAAc,IAAI,IAAI;IAEtB,mEAAmE;IACnE,gBAAgB,IAAI,IAAI;IAExB;;;;;;;OAOG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;CACnD;;AAED,wBAAmE"}

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;AA6JzD,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\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, 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"]}

package/ios/BeaconApiForwarder.swift

@@ -0,0 +1,104 @@
+import Foundation
+import os.log
+
+private let API_URL_KEY = "expo.beacon.api_url"
+private let API_KEY_KEY = "expo.beacon.api_key"
+private let MAX_RETRIES = 3
+
+/// Fire-and-forget HTTP event forwarder for beacon events.
+/// Sends enter/exit/timeout events to a configured API endpoint from native code,
+/// ensuring delivery even when the JS bridge is not active (app backgrounded).
+final class BeaconApiForwarder {
+
+    private let defaults: UserDefaults
+    private let session: URLSession
+
+    var isConfigured: Bool {
+        guard let url = defaults.string(forKey: API_URL_KEY) else { return false }
+        return !url.isEmpty
+    }
+
+    init(defaults: UserDefaults? = nil) {
+        self.defaults = defaults ?? (UserDefaults(suiteName: "expo.modules.beacon") ?? .standard)
+        let config = URLSessionConfiguration.default
+        config.timeoutIntervalForRequest = 10
+        config.timeoutIntervalForResource = 30
+        // Use background-safe waitsForConnectivity so requests survive brief connectivity gaps
+        config.waitsForConnectivity = true
+        self.session = URLSession(configuration: config)
+    }
+
+    func configure(url: String, apiKey: String?) {
+        defaults.set(url, forKey: API_URL_KEY)
+        if let key = apiKey {
+            defaults.set(key, forKey: API_KEY_KEY)
+        } else {
+            defaults.removeObject(forKey: API_KEY_KEY)
+        }
+    }
+
+    func getConfig() -> [String: String?] {
+        return [
+            "url": defaults.string(forKey: API_URL_KEY),
+            "apiKey": defaults.string(forKey: API_KEY_KEY)
+        ]
+    }
+
+    /// Send a beacon event to the configured API endpoint.
+    /// Fire-and-forget with simple retry (3 attempts, exponential backoff).
+    /// No-op if no endpoint is configured.
+    func forwardEvent(_ params: [String: Any]) {
+        guard let urlString = defaults.string(forKey: API_URL_KEY),
+              !urlString.isEmpty,
+              let url = URL(string: urlString) else { return }
+
+        let apiKey = defaults.string(forKey: API_KEY_KEY)
+
+        var payload = params
+        payload["timestamp"] = Int64(Date().timeIntervalSince1970 * 1000)
+        payload["platform"] = "ios"
+        payload["sdkVersion"] = ProcessInfo.processInfo.operatingSystemVersion.majorVersion
+
+        guard let body = try? JSONSerialization.data(withJSONObject: payload) else {
+            os_log(.error, "BeaconApiForwarder: failed to serialize payload")
+            return
+        }
+
+        sendWithRetry(url: url, body: body, apiKey: apiKey, attempt: 1)
+    }
+
+    private func sendWithRetry(url: URL, body: Data, apiKey: String?, attempt: Int) {
+        var request = URLRequest(url: url)
+        request.httpMethod = "POST"
+        request.setValue("application/json", forHTTPHeaderField: "Content-Type")
+        if let key = apiKey {
+            request.setValue(key, forHTTPHeaderField: "X-API-Key")
+        }
+        request.httpBody = body
+
+        let task = session.dataTask(with: request) { [weak self] _, response, error in
+            let statusCode = (response as? HTTPURLResponse)?.statusCode ?? 0
+
+            if statusCode >= 200 && statusCode < 300 {
+                return // Success
+            }
+
+            // 4xx client errors — don't retry
+            if statusCode >= 400 && statusCode < 500 {
+                os_log(.error, "BeaconApiForwarder: HTTP %{public}d — not retrying", statusCode)
+                return
+            }
+
+            if attempt < MAX_RETRIES {
+                let delay = pow(2.0, Double(attempt - 1)) // 1s, 2s, 4s
+                DispatchQueue.global(qos: .utility).asyncAfter(deadline: .now() + delay) {
+                    self?.sendWithRetry(url: url, body: body, apiKey: apiKey, attempt: attempt + 1)
+                }
+            } else {
+                let msg = error?.localizedDescription ?? "HTTP \(statusCode)"
+                os_log(.error, "BeaconApiForwarder: failed after %d attempts: %{public}@", MAX_RETRIES, msg)
+            }
+        }
+        task.resume()
+    }
+}

package/ios/ExpoBeaconModule.swift

@@ -11,12 +11,17 @@ private let MAX_DISTANCE_KEY = "expo.beacon.max_distance"
 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"
+
+/// Default minimum RSSI (dBm) below which beacon readings are discarded as unreliable.
+private let DEFAULT_MIN_RSSI: Int = -85
 
 /// Number of consecutive ranging misses before emitting a distance-based exit event.
-/// With ~1 s CoreLocation ranging cycles, 10 misses ≈ 10 s of silence before
-/// declaring exit — tolerant of brief ranging gaps while still responsive.
-/// NOTE: Android uses the same value but with a different scan cycle (~2.1 s).
-private let EXIT_MISS_THRESHOLD = 10
+/// 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.
 /// IMPORTANT: Keep in sync with BeaconConstants.kt (Android).
 private let HYSTERESIS_COUNT = 3
@@ -24,8 +29,9 @@ private let HYSTERESIS_COUNT = 3
 /// Eddystone monitoring timer interval in seconds.
 private let EDDYSTONE_MONITORING_TICK_INTERVAL: TimeInterval = 2.0
 /// Maximum age (in seconds) before a beacon is considered "not recently seen".
-/// Set higher than a few tick intervals to tolerate brief BLE advertisement gaps.
-private let EDDYSTONE_RECENTLY_SEEN_THRESHOLD: TimeInterval = 8.0
+/// Set high enough to tolerate iOS background CoreBluetooth throttling which
+/// can cause 10-12 s gaps between Eddystone advertisements.
+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
 
@@ -89,6 +95,16 @@ public class ExpoBeaconModule: Module {
     private var eddystoneExitCounters: [String: Int] = [:]
     private var eddystoneLastDistanceEmit: [String: Date] = [:]
 
+    /// Minimum RSSI threshold — readings below this are treated as unreliable.
+    private var minRssiThreshold: Int = DEFAULT_MIN_RSSI
+
+    /// Distance smoothing (EMA) state per identifier.
+    private var smoothedDistances: [String: Double] = [:]
+    /// EMA weight for new readings. 0.4 balances responsiveness vs noise rejection.
+    private static let DISTANCE_EMA_ALPHA = 0.4
+    /// If raw distance differs from smoothed by more than this factor, treat as outlier.
+    private static let DISTANCE_JUMP_FACTOR = 5.0
+
     // Permission callback
     private var permissionCompletion: ((Bool) -> Void)?
 
@@ -100,6 +116,9 @@ public class ExpoBeaconModule: Module {
     private var eventLogger: BeaconEventLogger?
     private var loggingEnabled = false
 
+    // Native API forwarder (fire-and-forget HTTP)
+    private lazy var apiForwarder = BeaconApiForwarder(defaults: defaults)
+
     // Timeout timers — fire once after beacon stays in range for configured duration
     private var beaconTimeoutTimers: [String: DispatchWorkItem] = [:]
     private var eddystoneTimeoutTimers: [String: DispatchWorkItem] = [:]
@@ -305,11 +324,13 @@ public class ExpoBeaconModule: Module {
         AsyncFunction("startMonitoring") { (options: Either<Double, [String: Any]>?, promise: Promise) in
             var maxDistance: Double? = nil
             var exitDistance: Double? = nil
+            var minRssi: Int? = 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
                 if let notifications = map["notifications"] as? [String: Any],
                    let data = try? JSONSerialization.data(withJSONObject: notifications),
                    let json = String(data: data, encoding: .utf8) {
@@ -342,6 +363,13 @@ public class ExpoBeaconModule: Module {
             } else {
                 self.defaults.removeObject(forKey: EXIT_DISTANCE_KEY)
             }
+            if let rssi = minRssi {
+                self.defaults.set(rssi, forKey: MIN_RSSI_KEY)
+                self.minRssiThreshold = rssi
+            } else {
+                self.defaults.removeObject(forKey: MIN_RSSI_KEY)
+                self.minRssiThreshold = DEFAULT_MIN_RSSI
+            }
             self.defaults.set(true, forKey: IS_MONITORING_KEY)
             self.requestLocationPermission { granted in
                 guard granted else {
@@ -454,6 +482,12 @@ public class ExpoBeaconModule: Module {
             self.eventLogger = nil
         }
 
+        // MARK: - API Forwarding
+
+        Function("setApiEndpoint") { (url: String, apiKey: String?) -> Void in
+            self.apiForwarder.configure(url: url, apiKey: apiKey)
+        }
+
         // MARK: - Battery Optimization (Android-only; no-op on iOS)
 
         Function("isBatteryOptimizationExempt") { () -> Bool in
@@ -537,6 +571,10 @@ public class ExpoBeaconModule: Module {
     private func startRegionMonitoring() {
         stopRegionMonitoring()
 
+        // Restore persisted min RSSI threshold (survives app restarts)
+        let storedRssi = defaults.object(forKey: MIN_RSSI_KEY) as? Int
+        minRssiThreshold = storedRssi ?? DEFAULT_MIN_RSSI
+
         let beacons = loadPairedBeaconsRaw()
 
         // CLLocationManager supports a maximum of 20 monitored regions.
@@ -599,6 +637,7 @@ public class ExpoBeaconModule: Module {
         missCounters.removeAll()
         enterCounters.removeAll()
         exitCounters.removeAll()
+        smoothedDistances.removeAll()
 
         for timer in beaconTimeoutTimers.values { timer.cancel() }
         beaconTimeoutTimers.removeAll()
@@ -738,6 +777,10 @@ public class ExpoBeaconModule: Module {
 
         guard let beacon = Self.parseEddystoneFrame(data: data, rssi: rssi.intValue) else { return }
 
+        // Discard weak signals that produce unreliable distance estimates
+        let beaconRssi = rssi.intValue
+        guard beaconRssi >= minRssiThreshold else { return }
+
         // Augment with the BLE advertising device name if present
         var beaconInfo = beacon
         if let localName = advertisementData[CBAdvertisementDataLocalNameKey] as? String {
@@ -775,9 +818,19 @@ 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
+                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
+                } else {
+                    effectiveDistance = distance
+                }
                 let action = evaluateDistanceHysteresis(
                     identifier: identifier,
-                    distance: distance,
+                    distance: effectiveDistance,
                     maxDistance: maxDist,
                     exitDistance: exitDist,
                     entered: &eddystoneEnteredRegions,
@@ -791,7 +844,8 @@ public class ExpoBeaconModule: Module {
                         "namespace": ns,
                         "instance": inst,
                         "event": "enter",
-                        "distance": distance
+                        "distance": distance,
+                        "rssi": beaconRssi
                     ])
                     postBeaconNotification(identifier: identifier, eventType: "enter")
                     scheduleEddystoneTimeout(identifier: identifier, namespace: ns, instance: inst)
@@ -802,7 +856,8 @@ public class ExpoBeaconModule: Module {
                         "namespace": ns,
                         "instance": inst,
                         "event": "exit",
-                        "distance": distance
+                        "distance": distance,
+                        "rssi": beaconRssi
                     ])
                     postBeaconNotification(identifier: identifier, eventType: "exit")
                 case .none:
@@ -825,7 +880,8 @@ public class ExpoBeaconModule: Module {
                 "identifier": identifier,
                 "namespace": ns,
                 "instance": inst,
-                "distance": distance
+                "distance": distance,
+                "rssi": beaconRssi
             ])
             break
         }
@@ -901,6 +957,10 @@ 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)
+        }
         sendEvent(eventName, params)
     }
 
@@ -980,6 +1040,8 @@ public class ExpoBeaconModule: Module {
         eddystoneEnterCounters.removeAll()
         eddystoneExitCounters.removeAll()
         eddystoneLastDistanceEmit.removeAll()
+        // Eddystone smoothed distances are in the shared smoothedDistances map;
+        // they are cleaned up when stopRegionMonitoring clears the entire map.
 
         for timer in eddystoneTimeoutTimers.values { timer.cancel() }
         eddystoneTimeoutTimers.removeAll()
@@ -1001,9 +1063,9 @@ public class ExpoBeaconModule: Module {
                 continue
             }
 
-            // Not seen recently — break distance hysteresis streaks and, if the
-            // beacon was already entered, increment miss counter toward exit.
-            eddystoneEnterCounters[identifier] = 0
+            // 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.
             eddystoneExitCounters[identifier] = 0
             guard eddystoneEnteredRegions.contains(identifier) else { continue }
 
@@ -1130,7 +1192,24 @@ public class ExpoBeaconModule: Module {
         return dict
     }
 
-    // MARK: - Distance-based enter/exit hysteresis
+    // MARK: - Distance smoothing + enter/exit hysteresis
+
+    /// Apply exponential moving average (EMA) smoothing to a raw distance reading.
+    /// Returns nil if the reading is a jump outlier (raw differs from smoothed by > DISTANCE_JUMP_FACTOR).
+    private func smoothDistance(identifier: String, rawDistance: Double) -> Double? {
+        guard let prev = smoothedDistances[identifier] else {
+            smoothedDistances[identifier] = rawDistance
+            return rawDistance
+        }
+        // Jump guard: if the raw value is wildly different, treat as outlier
+        let ratio = prev > 0.001 ? rawDistance / prev : rawDistance
+        if ratio > Self.DISTANCE_JUMP_FACTOR || (ratio > 0 && ratio < 1.0 / Self.DISTANCE_JUMP_FACTOR) {
+            return nil
+        }
+        let smoothed = Self.DISTANCE_EMA_ALPHA * rawDistance + (1 - Self.DISTANCE_EMA_ALPHA) * prev
+        smoothedDistances[identifier] = smoothed
+        return smoothed
+    }
 
     private enum HysteresisAction {
         case none, enter, exit
@@ -1204,7 +1283,8 @@ public class ExpoBeaconModule: Module {
             "uuid": (beacon?.uuid ?? region?.uuid)?.uuidString.uppercased() ?? "",
             "major": beacon?.major.intValue ?? region?.major?.intValue ?? 0,
             "minor": beacon?.minor.intValue ?? region?.minor?.intValue ?? 0,
-            "distance": beacon != nil ? beacon!.accuracy : distance
+            "distance": beacon != nil ? beacon!.accuracy : distance,
+            "rssi": beacon?.rssi ?? 0
         ]
         if let event = event {
             params["event"] = event
@@ -1237,7 +1317,7 @@ public class ExpoBeaconModule: Module {
 
         // 2. Distance-ranging for monitored beacons
         if let (identifier, _) = distanceRangingConstraints.first(where: { $0.value == constraint }) {
-            let validBeacon = beacons.first(where: { $0.accuracy >= 0 })
+            let validBeacon = beacons.first(where: { $0.accuracy >= 0 && $0.rssi >= minRssiThreshold })
 
             if let beacon = validBeacon {
                 // Got a valid reading — reset miss counter
@@ -1252,9 +1332,16 @@ public class ExpoBeaconModule: Module {
                 // (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
+
+                // 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
+                }
+
                 let action = evaluateDistanceHysteresis(
                     identifier: identifier,
-                    distance: beacon.accuracy,
+                    distance: smoothed,
                     maxDistance: maxDist,
                     exitDistance: exitDist,
                     entered: &enteredRegions,
@@ -1278,8 +1365,9 @@ public class ExpoBeaconModule: Module {
                 // UUID-only constraints in check 3 below, not here, to avoid
                 // duplicate events when both monitoring and continuous scan are active.
             } else {
-                // No valid beacon reading — beacon may have disappeared
-                enterCounters[identifier] = 0
+                // 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.
                 exitCounters[identifier] = 0
                 let count = (missCounters[identifier] ?? 0) + 1
                 missCounters[identifier] = count

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-beacon",
-  "version": "0.6.8",
+  "version": "0.6.10",
   "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

@@ -40,6 +40,8 @@ export type BeaconRegionEvent = {
   event: "enter" | "exit";
   /** Measured distance in metres at the time of the event (–1 if unavailable). */
   distance: number;
+  /** Signal strength in dBm at the time of the event (0 if unavailable). */
+  rssi?: number;
 };
 
 /** Payload for periodic distance update events during monitoring. */
@@ -49,6 +51,8 @@ export type BeaconDistanceEvent = {
   major: number;
   minor: number;
   distance: number;
+  /** Signal strength in dBm (0 if unavailable). */
+  rssi?: number;
 };
 
 /** Payload for beacon timeout events (beacon in range for configured duration). */
@@ -129,6 +133,14 @@ export type MonitoringOptions = {
    * Only used when `maxDistance` is set.
    */
   exitDistance?: number;
+  /**
+   * Minimum RSSI (dBm) for a beacon reading to be considered valid.
+   * Readings below this threshold are discarded as unreliable, preventing
+   * false detections from reflected or distant signals.
+   *
+   * Default: -85. Typical range: -100 (very permissive) to -70 (strict).
+   */
+  minRssi?: number;
   /** Notification configuration overrides to apply for this monitoring session. */
   notifications?: NotificationConfig;
 };
@@ -182,6 +194,8 @@ export type EddystoneRegionEvent = {
   event: "enter" | "exit";
   /** Measured distance in metres at the time of the event (–1 if unavailable). */
   distance: number;
+  /** Signal strength in dBm at the time of the event (0 if unavailable). */
+  rssi?: number;
 };
 
 /** Payload for periodic Eddystone distance update events during monitoring. */
@@ -190,6 +204,8 @@ export type EddystoneDistanceEvent = {
   namespace: string;
   instance: string;
   distance: number;
+  /** Signal strength in dBm (0 if unavailable). */
+  rssi?: number;
 };
 
 /** Payload for Eddystone timeout events (beacon in range for configured duration). */

package/src/ExpoBeaconModule.ts

@@ -153,6 +153,16 @@ declare class ExpoBeaconModule extends NativeModule<ExpoBeaconModuleEvents> {
 
   /** Delete the entire event log database. Also disables logging. */
   destroyEventLogs(): void;
+
+  /**
+   * Configure a remote API endpoint for native event forwarding.
+   * Once set, enter/exit/timeout 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.
+   * @param apiKey Optional API key sent as X-API-Key header.
+   */
+  setApiEndpoint(url: string, apiKey?: string): void;
 }
 
 export default requireNativeModule<ExpoBeaconModule>("ExpoBeacon");