expo-beacon 0.6.20 → 0.7.0

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

@@ -26,8 +26,14 @@ internal const val MONITORING_SCAN_PERIOD_MS = 1100L
  */
 internal const val MONITORING_BETWEEN_SCAN_PERIOD_MS = 1000L
 
-/** Ignore monitor-based exits if ranging saw the beacon within this window. */
-internal const val RECENT_RANGING_SIGHTING_GRACE_MS = 25000L
+/**
+ * Grace window after the last ranging sighting during which MonitorNotifier.didExitRegion
+ * is suppressed. Matched to REGION_EXIT_PERIOD_MS so that a monitor-level exit is only
+ * honoured when ranging has *also* been silent for the full exit period — preventing
+ * false exits caused by Android 17+'s intermittent BLE scan gaps where ranging may
+ * be briefly quiet even though the beacon is still within range.
+ */
+internal const val RECENT_RANGING_SIGHTING_GRACE_MS = REGION_EXIT_PERIOD_MS
 
 /**
  * Number of consecutive ranging misses before emitting a distance-based exit event.

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

@@ -22,6 +22,19 @@ class BeaconEventReceiver(
 
         val identifier = intent.getStringExtra("identifier") ?: return
         val eventType = intent.getStringExtra("event") ?: return
+
+        // Handle error events uniformly — no beacon coordinates needed
+        if (eventType == "error") {
+            val errorCode = intent.getStringExtra("errorCode") ?: ""
+            val errorMessage = intent.getStringExtra("errorMessage") ?: ""
+            onEvent("onBeaconError", mapOf(
+                "identifier" to identifier,
+                "code" to errorCode,
+                "message" to errorMessage
+            ))
+            return
+        }
+
         val beaconType = intent.getStringExtra("beaconType") ?: "ibeacon"
         val distance = intent.getDoubleExtra("distance", -1.0)
         val rssi = intent.getIntExtra("rssi", 0)

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

@@ -115,6 +115,7 @@ class BeaconForegroundService : Service(), BeaconConsumer {
             // SecurityException on Android 14+ if BT permissions missing,
             // or other platform-specific issues. Stop gracefully instead of crashing.
             Log.e(TAG, "startForeground failed — stopping service", e)
+            sendErrorBroadcast(null, "SERVICE_START_FAILED", "startForeground failed — stopping service: ${e.message}")
             stopSelf()
             return START_NOT_STICKY
         }
@@ -214,6 +215,12 @@ class BeaconForegroundService : Service(), BeaconConsumer {
                 beaconManager.startMonitoringBeaconsInRegion(region)
             } catch (e: RemoteException) {
                 Log.e(TAG, "Failed to start monitoring iBeacon region ${region.uniqueId}", e)
+                sendErrorBroadcast(region.uniqueId, "MONITORING_FAILED", "Failed to start monitoring iBeacon region ${region.uniqueId}")
+            } catch (e: SecurityException) {
+                // Android 17+ may throw SecurityException if BLUETOOTH_SCAN/CONNECT were
+                // not held at the exact moment monitoring starts.
+                Log.e(TAG, "Security exception starting monitoring for ${region.uniqueId} — check BT permissions", e)
+                sendErrorBroadcast(region.uniqueId, "SECURITY_EXCEPTION", "Security exception starting monitoring for ${region.uniqueId} — check BT permissions")
             }
             // Start ranging this region for distance logging
             if (distanceLogRegions.add(region)) {
@@ -222,6 +229,11 @@ class BeaconForegroundService : Service(), BeaconConsumer {
                 } catch (e: RemoteException) {
                     distanceLogRegions.remove(region)
                     Log.e(TAG, "Failed to start ranging iBeacon region ${region.uniqueId}", e)
+                    sendErrorBroadcast(region.uniqueId, "RANGING_FAILED", "Failed to start ranging iBeacon region ${region.uniqueId}")
+                } catch (e: SecurityException) {
+                    distanceLogRegions.remove(region)
+                    Log.e(TAG, "Security exception starting ranging for ${region.uniqueId} — check BT permissions", e)
+                    sendErrorBroadcast(region.uniqueId, "SECURITY_EXCEPTION", "Security exception starting ranging for ${region.uniqueId} — check BT permissions")
                 }
             }
         }
@@ -244,6 +256,10 @@ class BeaconForegroundService : Service(), BeaconConsumer {
                 beaconManager.startMonitoringBeaconsInRegion(region)
             } catch (ex: RemoteException) {
                 Log.e(TAG, "Failed to start monitoring Eddystone region $identifier", ex)
+                sendErrorBroadcast(identifier, "MONITORING_FAILED", "Failed to start monitoring Eddystone region $identifier")
+            } catch (ex: SecurityException) {
+                Log.e(TAG, "Security exception starting monitoring for Eddystone $identifier — check BT permissions", ex)
+                sendErrorBroadcast(identifier, "SECURITY_EXCEPTION", "Security exception starting monitoring for Eddystone $identifier — check BT permissions")
             }
             if (distanceLogRegions.add(region)) {
                 try {
@@ -251,6 +267,11 @@ class BeaconForegroundService : Service(), BeaconConsumer {
                 } catch (ex: RemoteException) {
                     distanceLogRegions.remove(region)
                     Log.e(TAG, "Failed to start ranging Eddystone region $identifier", ex)
+                    sendErrorBroadcast(identifier, "RANGING_FAILED", "Failed to start ranging Eddystone region $identifier")
+                } catch (ex: SecurityException) {
+                    distanceLogRegions.remove(region)
+                    Log.e(TAG, "Security exception starting ranging for Eddystone $identifier — check BT permissions", ex)
+                    sendErrorBroadcast(identifier, "SECURITY_EXCEPTION", "Security exception starting ranging for Eddystone $identifier — check BT permissions")
                 }
             }
         }
@@ -358,10 +379,15 @@ class BeaconForegroundService : Service(), BeaconConsumer {
                     HysteresisAction.NONE -> {}
                 }
             } else {
-                // No valid beacon reading — break distance hysteresis streaks and
-                // track consecutive misses for disappearance-based exit detection.
-                enterCounters[region.uniqueId] = 0
-                exitCounters[region.uniqueId] = 0
+                // No valid beacon reading — track consecutive misses for disappearance-based
+                // exit detection. enterCounters/exitCounters are intentionally NOT reset here.
+                // 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
+                // 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
 
@@ -565,6 +591,24 @@ class BeaconForegroundService : Service(), BeaconConsumer {
         sendBroadcast(intent)
     }
 
+    private fun sendErrorBroadcast(identifier: String?, code: String, message: String) {
+        val params = buildMap<String, Any?> {
+            put("identifier", identifier ?: "")
+            put("event", "error")
+            put("code", code)
+            put("message", message)
+        }
+        logBeaconEvent("onBeaconError", params)
+        val intent = Intent(ACTION_BEACON_EVENT).apply {
+            putExtra("identifier", identifier ?: "")
+            putExtra("event", "error")
+            putExtra("errorCode", code)
+            putExtra("errorMessage", message)
+            setPackage(packageName)
+        }
+        sendBroadcast(intent)
+    }
+
     private fun monitoringEventName(isEddystone: Boolean, eventType: String): String? {
         return when (eventType) {
             "enter" -> if (isEddystone) "onEddystoneEnter" else "onBeaconEnter"

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

@@ -85,15 +85,17 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
     override fun definition() = ModuleDefinition {
         Name("ExpoBeacon")
 
-        Events("onBeaconEnter", "onBeaconExit", "onBeaconDistance", "onBeaconTimeout", "onBeaconFound", "onEddystoneFound", "onEddystoneEnter", "onEddystoneExit", "onEddystoneDistance", "onEddystoneTimeout")
+        Events("onBeaconEnter", "onBeaconExit", "onBeaconDistance", "onBeaconTimeout", "onBeaconFound", "onEddystoneFound", "onEddystoneEnter", "onEddystoneExit", "onEddystoneDistance", "onEddystoneTimeout", "onBeaconError")
 
         AsyncFunction("scanForBeaconsAsync") { uuids: List<String>?, scanDurationMs: Int, promise: Promise ->
             if (scanDurationMs <= 0) {
                 promise.reject("INVALID_DURATION", "Scan duration must be a positive integer", null)
+                sendEvent("onBeaconError", mapOf("identifier" to "", "code" to "INVALID_DURATION", "message" to "Scan duration must be a positive integer"))
                 return@AsyncFunction
             }
             if (scanPromise != null || eddystoneScanPromise != null) {
                 promise.reject("SCAN_IN_PROGRESS", "A scan is already running", null)
+                sendEvent("onBeaconError", mapOf("identifier" to "", "code" to "SCAN_IN_PROGRESS", "message" to "A scan is already running"))
                 return@AsyncFunction
             }
             scanResults.clear()
@@ -120,12 +122,14 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
             if (scanPromise != null) {
                 cancelActiveScan()
                 scanPromise?.reject("SCAN_CANCELLED", "Scan was cancelled", null)
+                sendEvent("onBeaconError", mapOf("identifier" to "", "code" to "SCAN_CANCELLED", "message" to "Scan was cancelled"))
                 scanPromise = null
                 scanUuidFilter = emptySet()
             }
             if (eddystoneScanPromise != null) {
                 cancelActiveScan()
                 eddystoneScanPromise?.reject("SCAN_CANCELLED", "Scan was cancelled", null)
+                sendEvent("onBeaconError", mapOf("identifier" to "", "code" to "SCAN_CANCELLED", "message" to "Scan was cancelled"))
                 eddystoneScanPromise = null
             }
             unbindIfIdle()
@@ -158,10 +162,12 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
         AsyncFunction("scanForEddystonesAsync") { scanDurationMs: Int, promise: Promise ->
             if (scanDurationMs <= 0) {
                 promise.reject("INVALID_DURATION", "Scan duration must be a positive integer", null)
+                sendEvent("onBeaconError", mapOf("identifier" to "", "code" to "INVALID_DURATION", "message" to "Scan duration must be a positive integer"))
                 return@AsyncFunction
             }
             if (scanPromise != null || eddystoneScanPromise != null) {
                 promise.reject("SCAN_IN_PROGRESS", "A scan is already running", null)
+                sendEvent("onBeaconError", mapOf("identifier" to "", "code" to "SCAN_IN_PROGRESS", "message" to "A scan is already running"))
                 return@AsyncFunction
             }
             scanResults.clear()
@@ -277,6 +283,7 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
         AsyncFunction("startMonitoring") { options: Any?, promise: Promise ->
             val ctx = appContext.reactContext ?: run {
                 promise.reject("NO_CONTEXT", "React context is not available", null)
+                sendEvent("onBeaconError", mapOf("identifier" to "", "code" to "NO_CONTEXT", "message" to "React context is not available"))
                 return@AsyncFunction
             }
             var maxDistance: Double? = null
@@ -302,18 +309,22 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
             }
             if (maxDistance != null && (!maxDistance.isFinite() || maxDistance <= 0.0)) {
                 promise.reject("INVALID_MAX_DISTANCE", "maxDistance must be a finite number greater than 0", null)
+                sendEvent("onBeaconError", mapOf("identifier" to "", "code" to "INVALID_MAX_DISTANCE", "message" to "maxDistance must be a finite number greater than 0"))
                 return@AsyncFunction
             }
             if (exitDistance != null && (!exitDistance.isFinite() || exitDistance <= 0.0)) {
                 promise.reject("INVALID_EXIT_DISTANCE", "exitDistance must be a finite number greater than 0", null)
+                sendEvent("onBeaconError", mapOf("identifier" to "", "code" to "INVALID_EXIT_DISTANCE", "message" to "exitDistance must be a finite number greater than 0"))
                 return@AsyncFunction
             }
             if (exitDistance != null && maxDistance == null) {
                 promise.reject("INVALID_EXIT_DISTANCE", "exitDistance requires maxDistance to be set", null)
+                sendEvent("onBeaconError", mapOf("identifier" to "", "code" to "INVALID_EXIT_DISTANCE", "message" to "exitDistance requires maxDistance to be set"))
                 return@AsyncFunction
             }
             if (maxDistance != null && exitDistance != null && exitDistance < maxDistance) {
                 promise.reject("INVALID_EXIT_DISTANCE", "exitDistance must be greater than or equal to maxDistance", null)
+                sendEvent("onBeaconError", mapOf("identifier" to "", "code" to "INVALID_EXIT_DISTANCE", "message" to "exitDistance must be greater than or equal to maxDistance"))
                 return@AsyncFunction
             }
             ctx.getSharedPreferences(MONITORING_OPTIONS_PREFS, Context.MODE_PRIVATE)
@@ -332,6 +343,7 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
                 ContextCompat.checkSelfPermission(ctx, Manifest.permission.ACCESS_BACKGROUND_LOCATION) == PackageManager.PERMISSION_GRANTED
             if (!hasLocation || !hasBgLocation) {
                 promise.reject("PERMISSION_DENIED", "Location permissions required for background monitoring. Call requestPermissionsAsync() first.", null)
+                sendEvent("onBeaconError", mapOf("identifier" to "", "code" to "PERMISSION_DENIED", "message" to "Location permissions required for background monitoring. Call requestPermissionsAsync() first."))
                 return@AsyncFunction
             }
             // Android 12+ requires BLUETOOTH_SCAN for BLE operations;
@@ -341,6 +353,7 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
                 val hasBtConnect = ContextCompat.checkSelfPermission(ctx, Manifest.permission.BLUETOOTH_CONNECT) == PackageManager.PERMISSION_GRANTED
                 if (!hasBtScan || !hasBtConnect) {
                     promise.reject("PERMISSION_DENIED", "Bluetooth permissions required for beacon monitoring. Call requestPermissionsAsync() first.", null)
+                    sendEvent("onBeaconError", mapOf("identifier" to "", "code" to "PERMISSION_DENIED", "message" to "Bluetooth permissions required for beacon monitoring. Call requestPermissionsAsync() first."))
                     return@AsyncFunction
                 }
             }
@@ -351,6 +364,7 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
             } catch (e: Exception) {
                 unregisterEventReceiver()
                 promise.reject("SERVICE_START_FAILED", "Failed to start monitoring service: ${e.message}", e)
+                sendEvent("onBeaconError", mapOf("identifier" to "", "code" to "SERVICE_START_FAILED", "message" to "Failed to start monitoring service: ${e.message}"))
                 return@AsyncFunction
             }
             promise.resolve(null)
@@ -365,6 +379,7 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
         AsyncFunction("stopMonitoring") { promise: Promise ->
             val ctx = appContext.reactContext ?: run {
                 promise.reject("NO_CONTEXT", "React context is not available", null)
+                sendEvent("onBeaconError", mapOf("identifier" to "", "code" to "NO_CONTEXT", "message" to "React context is not available"))
                 return@AsyncFunction
             }
             BeaconForegroundService.stop(ctx)
@@ -510,6 +525,7 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
         AsyncFunction("requestBatteryOptimizationExemption") { promise: Promise ->
             val ctx = appContext.reactContext ?: run {
                 promise.reject("NO_CONTEXT", "React context is not available", null)
+                sendEvent("onBeaconError", mapOf("identifier" to "", "code" to "NO_CONTEXT", "message" to "React context is not available"))
                 return@AsyncFunction
             }
             val pm = ctx.getSystemService(Context.POWER_SERVICE) as? PowerManager
@@ -532,6 +548,7 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
                 promise.resolve(true)
             } catch (e: Exception) {
                 promise.reject("BATTERY_OPT_ERROR", "Failed to open battery optimization settings: ${e.message}", e)
+                sendEvent("onBeaconError", mapOf("identifier" to "", "code" to "BATTERY_OPT_ERROR", "message" to "Failed to open battery optimization settings: ${e.message}"))
             }
         }
 

package/build/ExpoBeacon.types.d.ts

@@ -245,6 +245,15 @@ export type EddystoneTimeoutEvent = {
     /** Current distance in metres at the time the timeout fired. */
     distance: number;
 };
+/** Payload for native beacon error events (monitoring/ranging failures). */
+export type BeaconErrorEvent = {
+    /** Region or constraint identifier, empty string if unavailable. */
+    identifier: string;
+    /** Machine-readable error code (e.g. "MONITORING_FAILED", "RANGING_FAILED", "SECURITY_EXCEPTION"). */
+    code: string;
+    /** Human-readable error message from the native layer. */
+    message: string;
+};
 /** Module event map. */
 export type ExpoBeaconModuleEvents = {
     onBeaconEnter: (params: BeaconRegionEvent) => void;
@@ -261,6 +270,8 @@ export type ExpoBeaconModuleEvents = {
     onEddystoneDistance: (params: EddystoneDistanceEvent) => void;
     /** Fired once after a paired Eddystone has been continuously in range for its configured `timeoutSeconds`. */
     onEddystoneTimeout: (params: EddystoneTimeoutEvent) => void;
+    /** Fired when a native monitoring or ranging failure occurs (logged to DB and forwarded to JS). */
+    onBeaconError: (params: BeaconErrorEvent) => void;
 };
 /** Options for filtering event logs. */
 export type EventLogQueryOptions = {

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/** Module event map. */\r\nexport type ExpoBeaconModuleEvents = {\r\n  onBeaconEnter: (params: BeaconRegionEvent) => void;\r\n  onBeaconExit: (params: BeaconRegionEvent) => void;\r\n  onBeaconDistance: (params: BeaconDistanceEvent) => void;\r\n  /** Fired once after a paired beacon has been continuously in range for its configured `timeoutSeconds`. */\r\n  onBeaconTimeout: (params: BeaconTimeoutEvent) => void;\r\n  /** Fired continuously during a live scan as each iBeacon is detected. */\r\n  onBeaconFound: (params: BeaconScanResult) => void;\r\n  /** Fired continuously during a live scan as each Eddystone beacon is detected. */\r\n  onEddystoneFound: (params: EddystoneScanResult) => void;\r\n  onEddystoneEnter: (params: EddystoneRegionEvent) => void;\r\n  onEddystoneExit: (params: EddystoneRegionEvent) => void;\r\n  onEddystoneDistance: (params: EddystoneDistanceEvent) => void;\r\n  /** Fired once after a paired Eddystone has been continuously in range for its configured `timeoutSeconds`. */\r\n  onEddystoneTimeout: (params: EddystoneTimeoutEvent) => void;\r\n};\r\n\r\n/** Options for filtering event logs. */\r\nexport type EventLogQueryOptions = {\r\n  /** Maximum number of log entries to return (default: 1000, max: 10000). */\r\n  limit?: number;\r\n  /** Filter by event type (e.g. \"onBeaconEnter\", \"onBeaconExit\"). */\r\n  eventType?: string;\r\n  /** Only return events with timestamp >= this value (ms since epoch). */\r\n  sinceTimestamp?: number;\r\n};\r\n\r\n/** A single logged beacon event entry. */\r\nexport type EventLogEntry = {\r\n  id: number;\r\n  /** Timestamp in milliseconds since epoch. */\r\n  timestamp: number;\r\n  /** The event type that was logged (e.g. \"onBeaconEnter\"). */\r\n  eventType: string;\r\n  /** Beacon identifier, if available. */\r\n  identifier?: string;\r\n  /** The full event payload that was sent to JS. */\r\n  data: Record<string, unknown>;\r\n};\r\n"]}
+{"version":3,"file":"ExpoBeacon.types.js","sourceRoot":"","sources":["../src/ExpoBeacon.types.ts"],"names":[],"mappings":"","sourcesContent":["/** Raw beacon discovered during a scan. */\r\nexport type BeaconScanResult = {\r\n  uuid: string; // iBeacon proximity UUID (uppercase, formatted)\r\n  major: number; // iBeacon major value (0–65535)\r\n  minor: number; // iBeacon minor value (0–65535)\r\n  rssi: number; // Signal strength in dBm (negative number)\r\n  distance: number; // Estimated distance in meters\r\n  txPower: number; // Calibrated TX power\r\n  /** BLE advertising device name. May be undefined on iOS (CoreLocation does not expose it for iBeacon). */\r\n  name?: string;\r\n};\r\n\r\n/**\r\n * A beacon that has been paired/registered for monitoring.\r\n *\r\n * Note: Paired beacon data is stored unencrypted in UserDefaults (iOS) /\r\n * SharedPreferences (Android) and may be included in device backups.\r\n */\r\nexport type PairedBeacon = {\r\n  identifier: string; // User-defined label (e.g. \"lobby-door\")\r\n  uuid: string;\r\n  major: number;\r\n  minor: number;\r\n  /** BLE advertising device name, if provided at pairing time. */\r\n  name?: string;\r\n  /**\r\n   * Timeout in seconds. When set, the module fires `onBeaconTimeout` once\r\n   * after the beacon has been continuously in range for this duration.\r\n   * The timer resets if the beacon exits and re-enters range.\r\n   *\r\n   * The timeout countdown also starts if no BLE readings are received\r\n   * for 60 seconds (e.g. due to Doze mode or background throttling).\r\n   */\r\n  timeoutSeconds?: number;\r\n};\r\n\r\n/** Payload for enter/exit region events. */\r\nexport type BeaconRegionEvent = {\r\n  identifier: string; // Matches PairedBeacon.identifier\r\n  uuid: string;\r\n  major: number;\r\n  minor: number;\r\n  event: \"enter\" | \"exit\";\r\n  /** Measured distance in metres at the time of the event (–1 if unavailable). */\r\n  distance: number;\r\n  /** Signal strength in dBm at the time of the event (0 if unavailable). */\r\n  rssi?: number;\r\n};\r\n\r\n/** Payload for periodic distance update events during monitoring. */\r\nexport type BeaconDistanceEvent = {\r\n  identifier: string;\r\n  uuid: string;\r\n  major: number;\r\n  minor: number;\r\n  distance: number;\r\n  /** Signal strength in dBm (0 if unavailable). */\r\n  rssi?: number;\r\n};\r\n\r\n/** Payload for beacon timeout events (beacon in range for configured duration). */\r\nexport type BeaconTimeoutEvent = {\r\n  identifier: string;\r\n  uuid: string;\r\n  major: number;\r\n  minor: number;\r\n  /** Current distance in metres at the time the timeout fired. */\r\n  distance: number;\r\n};\r\n\r\n/** Configuration for beacon enter/exit event notifications. */\r\nexport type BeaconNotificationConfig = {\r\n  /** Whether to show enter/exit notifications. Default: true. */\r\n  enabled?: boolean;\r\n  /** Notification title on beacon enter. Default: \"Beacon Entered\". */\r\n  enterTitle?: string;\r\n  /** Notification title on beacon exit. Default: \"Beacon Exited\". */\r\n  exitTitle?: string;\r\n  /** 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"]}

package/ios/ExpoBeaconModule.swift

@@ -145,17 +145,19 @@ public class ExpoBeaconModule: Module {
             self.migrateUserDefaultsIfNeeded()
         }
 
-        Events("onBeaconEnter", "onBeaconExit", "onBeaconDistance", "onBeaconTimeout", "onBeaconFound", "onEddystoneFound", "onEddystoneEnter", "onEddystoneExit", "onEddystoneDistance", "onEddystoneTimeout")
+        Events("onBeaconEnter", "onBeaconExit", "onBeaconDistance", "onBeaconTimeout", "onBeaconFound", "onEddystoneFound", "onEddystoneEnter", "onEddystoneExit", "onEddystoneDistance", "onEddystoneTimeout", "onBeaconError")
 
         // MARK: - Scan
 
         AsyncFunction("scanForBeaconsAsync") { (uuids: [String], scanDurationMs: Int, promise: Promise) in
             guard scanDurationMs > 0 else {
                 promise.reject("INVALID_DURATION", "Scan duration must be a positive integer")
+                self.sendLoggedEvent("onBeaconError", ["identifier": "", "code": "INVALID_DURATION", "message": "Scan duration must be a positive integer"])
                 return
             }
             guard self.scanPromise == nil else {
                 promise.reject("SCAN_IN_PROGRESS", "A scan is already in progress")
+                self.sendLoggedEvent("onBeaconError", ["identifier": "", "code": "SCAN_IN_PROGRESS", "message": "A scan is already in progress"])
                 return
             }
 
@@ -181,6 +183,7 @@ public class ExpoBeaconModule: Module {
                     promise.reject("WILDCARD_NOT_SUPPORTED",
                         "iOS does not support wildcard iBeacon scanning. " +
                         "Provide at least one proximity UUID, or pair beacons first.")
+                    self.sendLoggedEvent("onBeaconError", ["identifier": "", "code": "WILDCARD_NOT_SUPPORTED", "message": "iOS does not support wildcard iBeacon scanning. Provide at least one proximity UUID, or pair beacons first."])
                     self.scanPromise = nil
                     return
                 }
@@ -188,6 +191,7 @@ public class ExpoBeaconModule: Module {
                 for uuidStr in uuids {
                     guard let uuid = UUID(uuidString: uuidStr) else {
                         promise.reject("INVALID_UUID", "Invalid UUID: \(uuidStr)")
+                        self.sendLoggedEvent("onBeaconError", ["identifier": "", "code": "INVALID_UUID", "message": "Invalid UUID: \(uuidStr)"])
                         self.scanPromise = nil
                         return
                     }
@@ -201,6 +205,7 @@ public class ExpoBeaconModule: Module {
             self.requestLocationPermission { granted in
                 guard granted else {
                     promise.reject("PERMISSION_DENIED", "Location permission required for beacon scanning")
+                    self.sendLoggedEvent("onBeaconError", ["identifier": "", "code": "PERMISSION_DENIED", "message": "Location permission required for beacon scanning"])
                     self.scanPromise = nil
                     return
                 }
@@ -356,18 +361,22 @@ public class ExpoBeaconModule: Module {
             }
             if let dist = maxDistance, (!dist.isFinite || dist <= 0) {
                 promise.reject("INVALID_MAX_DISTANCE", "maxDistance must be a finite number greater than 0")
+                self.sendLoggedEvent("onBeaconError", ["identifier": "", "code": "INVALID_MAX_DISTANCE", "message": "maxDistance must be a finite number greater than 0"])
                 return
             }
             if let exitDist = exitDistance, (!exitDist.isFinite || exitDist <= 0) {
                 promise.reject("INVALID_EXIT_DISTANCE", "exitDistance must be a finite number greater than 0")
+                self.sendLoggedEvent("onBeaconError", ["identifier": "", "code": "INVALID_EXIT_DISTANCE", "message": "exitDistance must be a finite number greater than 0"])
                 return
             }
             if exitDistance != nil && maxDistance == nil {
                 promise.reject("INVALID_EXIT_DISTANCE", "exitDistance requires maxDistance to be set")
+                self.sendLoggedEvent("onBeaconError", ["identifier": "", "code": "INVALID_EXIT_DISTANCE", "message": "exitDistance requires maxDistance to be set"])
                 return
             }
             if let dist = maxDistance, let exitDist = exitDistance, exitDist < dist {
                 promise.reject("INVALID_EXIT_DISTANCE", "exitDistance must be greater than or equal to maxDistance")
+                self.sendLoggedEvent("onBeaconError", ["identifier": "", "code": "INVALID_EXIT_DISTANCE", "message": "exitDistance must be greater than or equal to maxDistance"])
                 return
             }
             if let dist = maxDistance {
@@ -391,6 +400,7 @@ public class ExpoBeaconModule: Module {
             self.requestLocationPermission { granted in
                 guard granted else {
                     promise.reject("PERMISSION_DENIED", "Location permission required for monitoring")
+                    self.sendLoggedEvent("onBeaconError", ["identifier": "", "code": "PERMISSION_DENIED", "message": "Location permission required for monitoring"])
                     return
                 }
                 // Request Always authorization non-blockingly for background support.
@@ -452,10 +462,12 @@ public class ExpoBeaconModule: Module {
         AsyncFunction("scanForEddystonesAsync") { (scanDurationMs: Int, promise: Promise) in
             guard scanDurationMs > 0 else {
                 promise.reject("INVALID_DURATION", "Scan duration must be a positive integer")
+                self.sendLoggedEvent("onBeaconError", ["identifier": "", "code": "INVALID_DURATION", "message": "Scan duration must be a positive integer"])
                 return
             }
             guard self.eddystoneScanPromise == nil else {
                 promise.reject("SCAN_IN_PROGRESS", "An Eddystone scan is already in progress")
+                self.sendLoggedEvent("onBeaconError", ["identifier": "", "code": "SCAN_IN_PROGRESS", "message": "An Eddystone scan is already in progress"])
                 return
             }
             self.eddystoneScanPromise = promise
@@ -640,6 +652,7 @@ public class ExpoBeaconModule: Module {
         let maxRegions = 20
         if beacons.count > maxRegions {
             print("[ExpoBeacon] Warning: \(beacons.count) paired beacons exceeds the iOS limit of \(maxRegions) monitored regions. Only the first \(maxRegions) will be monitored.")
+            sendLoggedEvent("onBeaconError", ["identifier": "", "code": "REGION_LIMIT_EXCEEDED", "message": "\(beacons.count) paired beacons exceeds the iOS limit of \(maxRegions) monitored regions. Only the first \(maxRegions) will be monitored."])
         }
 
         for b in beacons.prefix(maxRegions) {
@@ -1363,6 +1376,7 @@ public class ExpoBeaconModule: Module {
               let data = json.data(using: .utf8) else { return [:] }
         guard let dict = try? JSONSerialization.jsonObject(with: data) as? [String: Any] else {
             print("[ExpoBeacon] Warning: failed to parse notification config JSON")
+            sendLoggedEvent("onBeaconError", ["identifier": "", "code": "CONFIG_PARSE_ERROR", "message": "Failed to parse notification config JSON"])
             return [:]
         }
         return dict
@@ -1626,10 +1640,20 @@ public class ExpoBeaconModule: Module {
         let id = region?.identifier ?? "unknown"
         Logger(subsystem: "expo.modules.beacon", category: "monitoring")
             .error("Monitoring failed for region \(id, privacy: .public): \(error.localizedDescription, privacy: .public)")
+        sendLoggedEvent("onBeaconError", [
+            "identifier": id,
+            "code": "MONITORING_FAILED",
+            "message": error.localizedDescription
+        ])
     }
 
     fileprivate func handleDidFailRanging(for constraint: CLBeaconIdentityConstraint, error: Error) {
         print("[ExpoBeacon] Ranging failed for constraint \(constraint.uuid): \(error.localizedDescription)")
+        sendLoggedEvent("onBeaconError", [
+            "identifier": constraint.uuid.uuidString,
+            "code": "RANGING_FAILED",
+            "message": error.localizedDescription
+        ])
 
         // If a one-shot scan is active and this constraint belongs to it, reject the promise
         if scanPromise != nil && scanConstraints.contains(where: { $0 == constraint }) {
@@ -1643,6 +1667,14 @@ public class ExpoBeaconModule: Module {
             scanPromise = nil
         }
     }
+
+    fileprivate func handleBluetoothStateError(code: String, message: String) {
+        sendLoggedEvent("onBeaconError", [
+            "identifier": "",
+            "code": code,
+            "message": message
+        ])
+    }
 }
 
 // MARK: - CLLocationManagerDelegate
@@ -1695,10 +1727,12 @@ private class BluetoothDelegate: NSObject, CBCentralManagerDelegate {
         case .unauthorized:
             print("[ExpoBeacon] Bluetooth authorization denied — Eddystone scanning/monitoring unavailable. " +
                   "Ensure NSBluetoothAlwaysUsageDescription is set in Info.plist.")
+            module?.handleBluetoothStateError(code: "BLUETOOTH_UNAUTHORIZED", message: "Bluetooth authorization denied — Eddystone scanning/monitoring unavailable")
             module?.eddystoneScanPromise?.reject("BLUETOOTH_UNAUTHORIZED", "Bluetooth permission denied")
             module?.eddystoneScanPromise = nil
         case .poweredOff:
             print("[ExpoBeacon] Bluetooth is powered off — Eddystone scanning/monitoring unavailable.")
+            module?.handleBluetoothStateError(code: "BLUETOOTH_OFF", message: "Bluetooth is powered off — Eddystone scanning/monitoring unavailable")
             module?.eddystoneScanPromise?.reject("BLUETOOTH_OFF", "Bluetooth is powered off")
             module?.eddystoneScanPromise = nil
         default:

package/package.json

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

@@ -265,6 +265,16 @@ export type EddystoneTimeoutEvent = {
   distance: number;
 };
 
+/** Payload for native beacon error events (monitoring/ranging failures). */
+export type BeaconErrorEvent = {
+  /** Region or constraint identifier, empty string if unavailable. */
+  identifier: string;
+  /** Machine-readable error code (e.g. "MONITORING_FAILED", "RANGING_FAILED", "SECURITY_EXCEPTION"). */
+  code: string;
+  /** Human-readable error message from the native layer. */
+  message: string;
+};
+
 /** Module event map. */
 export type ExpoBeaconModuleEvents = {
   onBeaconEnter: (params: BeaconRegionEvent) => void;
@@ -281,6 +291,8 @@ export type ExpoBeaconModuleEvents = {
   onEddystoneDistance: (params: EddystoneDistanceEvent) => void;
   /** Fired once after a paired Eddystone has been continuously in range for its configured `timeoutSeconds`. */
   onEddystoneTimeout: (params: EddystoneTimeoutEvent) => void;
+  /** Fired when a native monitoring or ranging failure occurs (logged to DB and forwarded to JS). */
+  onBeaconError: (params: BeaconErrorEvent) => void;
 };
 
 /** Options for filtering event logs. */