expo-beacon 0.2.0 → 0.3.0

package/README.md

@@ -11,7 +11,7 @@ An Expo module for scanning, pairing, and monitoring iBeacons in React Native ap
 | Platform | Native implementation                                                                                     |
 | -------- | --------------------------------------------------------------------------------------------------------- |
 | Android  | [AltBeacon](https://altbeacon.github.io/android-beacon-library/) (`org.altbeacon:android-beacon-library`) |
-| iOS      | CoreLocation / `CLLocationManager` (iBeacon native API)                                                   |
+| iOS      | CoreLocation (UUID-targeted scans & monitoring) + CoreBluetooth (wildcard scanning)                       |
 | Web      | Not supported (throws on all calls)                                                                        |
 
 ---
@@ -47,6 +47,8 @@ In Xcode under **Signing & Capabilities**, enable:
 - **Background Modes → Uses Bluetooth LE accessories**
 
 > iOS limits apps to **20 simultaneously monitored regions**.
+>
+> **Wildcard scanning**: When you call `scanForBeaconsAsync()` with an empty or omitted `uuids` array, iOS uses CoreBluetooth raw BLE scanning to discover all nearby iBeacons. This works **in the foreground only** — it is an Apple platform limitation. UUID-targeted scans and background monitoring continue to use CoreLocation.
 
 ### Android
 
@@ -111,7 +113,8 @@ export default function App() {
   }, []);
 
   async function scan() {
-    const results = await ExpoBeacon.scanForBeaconsAsync(5000);
+    // Wildcard scan — discovers all nearby iBeacons (no UUID filter)
+    const results = await ExpoBeacon.scanForBeaconsAsync([], 5000);
     setBeacons(results);
   }
 
@@ -158,23 +161,41 @@ if (!granted) {
 
 ---
 
-### `scanForBeaconsAsync(scanDurationMs?)`
+### `scanForBeaconsAsync(uuids?, scanDurationMs?)`
 
 ```ts
-scanForBeaconsAsync(scanDurationMs?: number): Promise<BeaconScanResult[]>
+scanForBeaconsAsync(uuids?: string[], scanDurationMs?: number): Promise<BeaconScanResult[]>
 ```
 
 Starts a **one-shot BLE scan**, waits for `scanDurationMs` milliseconds, then resolves with all beacons discovered during that window.
 
-| Parameter       | Type     | Default | Description                              |
-| --------------- | -------- | ------- | ---------------------------------------- |
-| `scanDurationMs`| `number` | `5000`  | How long to scan in milliseconds (1–60 000 recommended) |
+| Parameter        | Type       | Default | Description                              |
+| ---------------- | ---------- | ------- | ---------------------------------------- |
+| `uuids`          | `string[]` | `[]`    | Proximity UUIDs to filter by. Pass `[]` or omit for a **wildcard scan** that discovers all nearby iBeacons. |
+| `scanDurationMs` | `number`   | `5000`  | How long to scan in milliseconds (1–60 000 recommended) |
 
 Returns an array of [`BeaconScanResult`](#beaconscanresult) objects. Rejects with `SCAN_IN_PROGRESS` if another scan is already running.
 
+**Wildcard vs. targeted scans**
+
+| | Wildcard (`[]` / omitted) | Targeted (`['UUID-1', …]`) |
+|---|---|---|
+| **Android** | Discovers all iBeacons via AltBeacon | Filters results to matching UUIDs |
+| **iOS** | CoreBluetooth raw BLE scan (**foreground only**) | CoreLocation ranging (works in background) |
+
+> **iOS limitation**: Wildcard scanning uses CoreBluetooth, which cannot scan in the background. If your app is backgrounded during a wildcard scan, no new beacons will be discovered. Use UUID-targeted scans or `startMonitoring()` for background beacon detection.
+
 ```ts
-const beacons = await ExpoBeacon.scanForBeaconsAsync(8000); // 8-second scan
-beacons.forEach((b) =>
+// Wildcard scan — discover all nearby iBeacons
+const all = await ExpoBeacon.scanForBeaconsAsync([], 5000);
+
+// Targeted scan — only beacons matching these UUIDs
+const filtered = await ExpoBeacon.scanForBeaconsAsync(
+  ['E2C56DB5-DFFB-48D2-B060-D0F5A71096E0'],
+  8000,
+);
+
+filtered.forEach((b) =>
   console.log(`${b.uuid}  major=${b.major}  minor=${b.minor}  dist=${b.distance.toFixed(1)}m  rssi=${b.rssi}dBm`)
 );
 ```
@@ -191,6 +212,8 @@ Begins a **continuous BLE scan** that fires an [`onBeaconFound`](#onbeaconfound)
 
 Unlike `scanForBeaconsAsync`, this never resolves — it streams results in real time.
 
+> **iOS note**: Due to CoreLocation API constraints, `startContinuousScan()` on iOS only ranges beacons that have been previously paired with `pairBeacon()`. On Android, all nearby BLE beacons are reported regardless of pairing status.
+
 ```ts
 const sub = ExpoBeacon.addListener("onBeaconFound", (beacon) => {
   console.log("Live:", beacon.uuid, beacon.distance);
@@ -420,15 +443,7 @@ ExpoBeacon.addListener("onBeaconExit", (e) => {
 
 ### `onBeaconRanging`
 
-Fired periodically during active monitoring with the latest ranging measurement for a paired beacon.
-
-**Payload**: [`BeaconRangingEvent`](#beaconrangingevent)
-
-```ts
-ExpoBeacon.addListener("onBeaconRanging", (e) => {
-  console.log(`Ranging ${e.identifier}: ${e.distance.toFixed(2)} m  rssi=${e.rssi}`);
-});
-```
+> **Not currently emitted.** This event is declared in the TypeScript types ([`BeaconRangingEvent`](#beaconrangingevent)) but is not fired by either the iOS or Android native implementation. Use [`onBeaconDistance`](#onbeacondistance) for periodic distance updates during monitoring.
 
 ---
 
@@ -507,7 +522,7 @@ type BeaconRegionEvent = {
 
 ### `BeaconRangingEvent`
 
-Payload for `onBeaconRanging`.
+Payload type for the `onBeaconRanging` event. **Declared for future use — this event is not currently emitted by either platform.** Use [`BeaconDistanceEvent`](#beacondistanceevent) and [`onBeaconDistance`](#onbeacondistance) for real-time distance updates.
 
 ```ts
 type BeaconRangingEvent = {
@@ -648,7 +663,7 @@ Both notifications share the channel id `expo_beacon_channel`. The channel is re
 
 ## Contributing
 
-Contributions are welcome! Please refer to the [contributing guide](https://github.com/expo/expo#contributing).
+Contributions are welcome! Open an issue or pull request on [GitHub](https://github.com/martinmikesCCS/expo-beacon).
 
 ## License
 

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

@@ -18,7 +18,12 @@ private const val PREFS_NAME = "expo.beacon.paired"
 private const val PREFS_KEY = "paired_beacons"
 private const val CHANNEL_ID = "expo_beacon_channel"
 private const val FOREGROUND_NOTIF_ID = 1001
-private const val ENTER_EXIT_NOTIF_ID = 1002
+private const val ENTER_EXIT_NOTIF_BASE_ID = 2000
+
+/// Number of consecutive ranging misses before emitting a distance-based exit event.
+private const val EXIT_MISS_THRESHOLD = 3
+/// Number of consecutive readings required to confirm a distance-based enter or exit transition.
+private const val HYSTERESIS_COUNT = 3
 
 class BeaconForegroundService : Service(), BeaconConsumer {
 
@@ -30,6 +35,16 @@ class BeaconForegroundService : Service(), BeaconConsumer {
     private val rangingRegions = java.util.concurrent.CopyOnWriteArraySet<Region>()
     private val enteredRegions = java.util.concurrent.CopyOnWriteArraySet<String>()
 
+    // Hysteresis counters (synchronized on distanceLock)
+    private val distanceLock = Any()
+    private val enterCounters = java.util.concurrent.ConcurrentHashMap<String, Int>()
+    private val exitCounters = java.util.concurrent.ConcurrentHashMap<String, Int>()
+    private val missCounters = java.util.concurrent.ConcurrentHashMap<String, Int>()
+
+    // Notification ID counter for unique per-beacon notifications
+    private var notifIdCounter = 0
+    private val notifIdMap = java.util.concurrent.ConcurrentHashMap<String, Int>()
+
     // Distance logging
     private val distanceLogRegions = java.util.concurrent.CopyOnWriteArraySet<Region>()
 
@@ -153,26 +168,62 @@ class BeaconForegroundService : Service(), BeaconConsumer {
             Log.d("BeaconMonitor", "[${region.uniqueId}] distance: ${"%.2f".format(closest.distance)} m  rssi=${closest.rssi}  txPower=${closest.txPower}")
             sendBeaconBroadcast(region, "distance", closest.distance)
 
+            // Reset miss counter — we got a valid reading
+            missCounters[region.uniqueId] = 0
+
             val maxDist = maxDistance
             if (maxDist != null) {
-                if (!enteredRegions.contains(region.uniqueId) && closest.distance <= maxDist) {
-                    // Distance-based entry
-                    Log.d("BeaconMonitor", "[${region.uniqueId}] distance ${closest.distance}m <= maxDistance ${maxDist}m — synthesizing enter")
-                    enteredRegions.add(region.uniqueId)
-                    rangingRegions.remove(region)
-                    sendBeaconBroadcast(region, "enter", closest.distance)
-                    showEnterExitNotification(region, "enter")
-                } else if (enteredRegions.contains(region.uniqueId) && closest.distance > maxDist) {
-                    // Distance-based exit
-                    Log.d("BeaconMonitor", "[${region.uniqueId}] distance ${closest.distance}m > maxDistance ${maxDist}m — synthesizing exit")
-                    enteredRegions.remove(region.uniqueId)
-                    rangingRegions.add(region)
-                    sendBeaconBroadcast(region, "exit", closest.distance)
-                    showEnterExitNotification(region, "exit")
+                synchronized(distanceLock) {
+                    if (closest.distance <= maxDist) {
+                        // Reading is inside threshold
+                        exitCounters[region.uniqueId] = 0
+                        val count = (enterCounters[region.uniqueId] ?: 0) + 1
+                        enterCounters[region.uniqueId] = count
+
+                        if (!enteredRegions.contains(region.uniqueId) && count >= HYSTERESIS_COUNT) {
+                            enteredRegions.add(region.uniqueId)
+                            enterCounters[region.uniqueId] = 0
+                            rangingRegions.remove(region)
+                            sendBeaconBroadcast(region, "enter", closest.distance)
+                            showEnterExitNotification(region, "enter")
+                        }
+                    } else {
+                        // Reading is outside threshold
+                        enterCounters[region.uniqueId] = 0
+                        val count = (exitCounters[region.uniqueId] ?: 0) + 1
+                        exitCounters[region.uniqueId] = count
+
+                        if (enteredRegions.contains(region.uniqueId) && count >= HYSTERESIS_COUNT) {
+                            enteredRegions.remove(region.uniqueId)
+                            exitCounters[region.uniqueId] = 0
+                            rangingRegions.add(region)
+                            sendBeaconBroadcast(region, "exit", closest.distance)
+                            showEnterExitNotification(region, "exit")
+                        }
+                    }
                 }
             }
         } else {
             Log.d("BeaconMonitor", "[${region.uniqueId}] no beacons in range")
+
+            // Beacon may have disappeared — track consecutive misses
+            val maxDist = maxDistance
+            if (maxDist != null) {
+                val count = (missCounters[region.uniqueId] ?: 0) + 1
+                missCounters[region.uniqueId] = count
+
+                if (enteredRegions.contains(region.uniqueId) && count >= EXIT_MISS_THRESHOLD) {
+                    synchronized(distanceLock) {
+                        if (enteredRegions.remove(region.uniqueId)) {
+                            missCounters[region.uniqueId] = 0
+                            enterCounters[region.uniqueId] = 0
+                            exitCounters[region.uniqueId] = 0
+                            sendBeaconBroadcast(region, "exit", -1.0)
+                            showEnterExitNotification(region, "exit")
+                        }
+                    }
+                }
+            }
         }
     }
 
@@ -190,8 +241,15 @@ class BeaconForegroundService : Service(), BeaconConsumer {
         }
 
         override fun didExitRegion(region: Region) {
-            // Remove from confirmation tracking (ranging stays active for distance logging)
             rangingRegions.remove(region)
+
+            if (maxDistance != null) {
+                // When maxDistance is set, distance ranging handles exit events.
+                // Just clean up tracked state so distance-driven exit can fire.
+                enteredRegions.remove(region.uniqueId)
+                return
+            }
+
             enteredRegions.remove(region.uniqueId)
             sendBeaconBroadcast(region, "exit", -1.0)
             showEnterExitNotification(region, "exit")
@@ -209,12 +267,19 @@ class BeaconForegroundService : Service(), BeaconConsumer {
             .filter { it.distance >= 0 }
             .minByOrNull { it.distance } ?: return@RangeNotifier
 
-        if (beacon.distance <= maxDist && !enteredRegions.contains(region.uniqueId)) {
-            enteredRegions.add(region.uniqueId)
-            // Remove from confirmation tracking (ranging stays active for distance logging)
-            rangingRegions.remove(region)
-            sendBeaconBroadcast(region, "enter", beacon.distance)
-            showEnterExitNotification(region, "enter")
+        synchronized(distanceLock) {
+            if (beacon.distance <= maxDist && !enteredRegions.contains(region.uniqueId)) {
+                val count = (enterCounters[region.uniqueId] ?: 0) + 1
+                enterCounters[region.uniqueId] = count
+
+                if (count >= HYSTERESIS_COUNT) {
+                    enteredRegions.add(region.uniqueId)
+                    enterCounters[region.uniqueId] = 0
+                    rangingRegions.remove(region)
+                    sendBeaconBroadcast(region, "enter", beacon.distance)
+                    showEnterExitNotification(region, "enter")
+                }
+            }
         }
     }
 
@@ -266,7 +331,10 @@ class BeaconForegroundService : Service(), BeaconConsumer {
             .build()
 
         try {
-            NotificationManagerCompat.from(this).notify(ENTER_EXIT_NOTIF_ID, notification)
+            val notifId = notifIdMap.getOrPut(region.uniqueId) {
+                ENTER_EXIT_NOTIF_BASE_ID + notifIdCounter++
+            }
+            NotificationManagerCompat.from(this).notify(notifId, notification)
         } catch (_: SecurityException) {
             // POST_NOTIFICATIONS not granted — silently skip notification
         }
@@ -288,12 +356,13 @@ class BeaconForegroundService : Service(), BeaconConsumer {
             }
 
             val notifMgr = getSystemService(NotificationManager::class.java)
-            // Delete and recreate so config changes take effect
-            notifMgr?.deleteNotificationChannel(CHANNEL_ID)
-            val channel = NotificationChannel(CHANNEL_ID, channelName, importance).apply {
-                description = channelDesc
+            // Only create channel if it doesn't exist yet — preserves user notification preferences
+            if (notifMgr?.getNotificationChannel(CHANNEL_ID) == null) {
+                val channel = NotificationChannel(CHANNEL_ID, channelName, importance).apply {
+                    description = channelDesc
+                }
+                notifMgr?.createNotificationChannel(channel)
             }
-            notifMgr?.createNotificationChannel(channel)
         }
     }
 
@@ -339,6 +408,10 @@ class BeaconForegroundService : Service(), BeaconConsumer {
         }
         distanceLogRegions.clear()
         enteredRegions.clear()
+        enterCounters.clear()
+        exitCounters.clear()
+        missCounters.clear()
+        notifIdMap.clear()
         monitoredRegions.forEach {
             try { beaconManager.stopMonitoringBeaconsInRegion(it) } catch (_: RemoteException) {}
         }

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

@@ -52,6 +52,7 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
     private var scanPromise: Promise? = null
     private var scanJob: Job? = null
     private val scanResults = mutableListOf<Beacon>()
+    private var scanUuidFilter: Set<String> = emptySet()
     private var isBoundForScan = false
 
     // Continuous scan state
@@ -61,14 +62,15 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
     override fun definition() = ModuleDefinition {
         Name("ExpoBeacon")
 
-        Events("onBeaconEnter", "onBeaconExit", "onBeaconRanging", "onBeaconDistance", "onBeaconFound")
+        Events("onBeaconEnter", "onBeaconExit", "onBeaconDistance", "onBeaconFound")
 
-        AsyncFunction("scanForBeaconsAsync") { scanDurationMs: Int, promise: Promise ->
+        AsyncFunction("scanForBeaconsAsync") { uuids: List<String>?, scanDurationMs: Int, promise: Promise ->
             if (scanPromise != null) {
                 promise.reject("SCAN_IN_PROGRESS", "A scan is already running", null)
                 return@AsyncFunction
             }
             scanResults.clear()
+            scanUuidFilter = uuids?.map { it.lowercase() }?.toSet() ?: emptySet()
             scanPromise = promise
 
             beaconManager.addRangeNotifier(scanRangeNotifier)
@@ -113,6 +115,19 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
         }
 
         Function("pairBeacon") { identifier: String, uuid: String, major: Int, minor: Int ->
+            // Validate UUID format
+            try {
+                java.util.UUID.fromString(uuid)
+            } catch (_: IllegalArgumentException) {
+                throw expo.modules.kotlin.exception.CodedException("INVALID_UUID", "Invalid UUID format: $uuid", null)
+            }
+            if (major !in 0..65535) {
+                throw expo.modules.kotlin.exception.CodedException("INVALID_MAJOR", "Major must be 0\u201365535, got $major", null)
+            }
+            if (minor !in 0..65535) {
+                throw expo.modules.kotlin.exception.CodedException("INVALID_MINOR", "Minor must be 0\u201365535, got $minor", null)
+            }
+
             val beacons = loadPairedBeaconsJson()
             // Remove duplicate if exists
             val filtered = (0 until beacons.length())
@@ -176,6 +191,15 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
                     if (maxDistance != null) putFloat("max_distance", maxDistance.toFloat())
                     else remove("max_distance")
                 }.apply()
+            // Verify we have the permissions needed for background monitoring
+            val hasLocation = ContextCompat.checkSelfPermission(ctx, Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED
+            val hasBgLocation = Build.VERSION.SDK_INT < Build.VERSION_CODES.Q ||
+                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)
+                return@AsyncFunction
+            }
+
             registerEventReceiver()
             BeaconForegroundService.start(ctx)
             promise.resolve(null)
@@ -195,7 +219,8 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
         }
 
         AsyncFunction("requestPermissionsAsync") { promise: Promise ->
-            val required = buildList {
+            // Step 1: request foreground permissions
+            val foreground = buildList {
                 add(Manifest.permission.ACCESS_FINE_LOCATION)
                 if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
                     add(Manifest.permission.BLUETOOTH_SCAN)
@@ -212,7 +237,7 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
                     promise.resolve(false)
                     return@AsyncFunction
                 }
-                val allGranted = required.all {
+                val allGranted = foreground.all {
                     ContextCompat.checkSelfPermission(context, it) == PackageManager.PERMISSION_GRANTED
                 }
                 promise.resolve(allGranted)
@@ -220,11 +245,24 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
             }
 
             permissionsManager.askForPermissions({ results ->
-                val allGranted = required.all { perm ->
+                val fgGranted = foreground.all { perm ->
                     results[perm]?.status == PermissionsStatus.GRANTED
                 }
-                promise.resolve(allGranted)
-            }, *required.toTypedArray())
+                if (!fgGranted) {
+                    promise.resolve(false)
+                    return@askForPermissions
+                }
+                // Step 2: request background location (Android 10+)
+                // Must be requested separately after foreground location is granted
+                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
+                    permissionsManager.askForPermissions({ bgResults ->
+                        val bgGranted = bgResults[Manifest.permission.ACCESS_BACKGROUND_LOCATION]?.status == PermissionsStatus.GRANTED
+                        promise.resolve(bgGranted)
+                    }, Manifest.permission.ACCESS_BACKGROUND_LOCATION)
+                } else {
+                    promise.resolve(true)
+                }
+            }, *foreground.toTypedArray())
         }
 
         OnDestroy {
@@ -266,7 +304,13 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
     }
 
     private val scanRangeNotifier = RangeNotifier { beacons, _ ->
-        scanResults.addAll(beacons)
+        if (scanUuidFilter.isEmpty()) {
+            scanResults.addAll(beacons)
+        } else {
+            scanResults.addAll(beacons.filter { beacon ->
+                scanUuidFilter.contains(beacon.id1.toString().lowercase())
+            })
+        }
     }
 
     private val continuousScanRangeNotifier = RangeNotifier { beacons, _ ->
@@ -309,6 +353,7 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
         }
         scanPromise?.resolve(results)
         scanPromise = null
+        scanUuidFilter = emptySet()
     }
 
     // --- Notification config helpers ---

package/build/ExpoBeacon.types.d.ts

@@ -24,15 +24,6 @@ export type BeaconRegionEvent = {
     /** Measured distance in metres at the time of the event (–1 if unavailable). */
     distance: number;
 };
-/** Payload for ranging events (beacon proximity update). */
-export type BeaconRangingEvent = {
-    identifier: string;
-    uuid: string;
-    major: number;
-    minor: number;
-    rssi: number;
-    distance: number;
-};
 /** Payload for periodic distance update events during monitoring. */
 export type BeaconDistanceEvent = {
     identifier: string;
@@ -103,7 +94,6 @@ export type MonitoringOptions = {
 export type ExpoBeaconModuleEvents = {
     onBeaconEnter: (params: BeaconRegionEvent) => void;
     onBeaconExit: (params: BeaconRegionEvent) => void;
-    onBeaconRanging: (params: BeaconRangingEvent) => void;
     onBeaconDistance: (params: BeaconDistanceEvent) => void;
     /** Fired continuously during a live scan as each beacon is detected. */
     onBeaconFound: (params: BeaconScanResult) => void;

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};\r\n\r\n/** A beacon that has been paired/registered for monitoring. */\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};\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 ranging events (beacon proximity update). */\r\nexport type BeaconRangingEvent = {\r\n  identifier: string;\r\n  uuid: string;\r\n  major: number;\r\n  minor: number;\r\n  rssi: number;\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/** 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  /** Notification configuration overrides to apply for this monitoring session. */\r\n  notifications?: NotificationConfig;\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  onBeaconRanging: (params: BeaconRangingEvent) => void;\r\n  onBeaconDistance: (params: BeaconDistanceEvent) => void;\r\n  /** Fired continuously during a live scan as each beacon is detected. */\r\n  onBeaconFound: (params: BeaconScanResult) => void;\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};\r\n\r\n/** A beacon that has been paired/registered for monitoring. */\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};\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/** 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  /** Notification configuration overrides to apply for this monitoring session. */\r\n  notifications?: NotificationConfig;\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 continuously during a live scan as each beacon is detected. */\r\n  onBeaconFound: (params: BeaconScanResult) => void;\r\n};\r\n"]}

package/build/ExpoBeaconModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoBeaconModule.d.ts","sourceRoot":"","sources":["../src/ExpoBeaconModule.ts"],"names":[],"mappings":"AAiFA,eAAe,MAAM,CAAC"}
+{"version":3,"file":"ExpoBeaconModule.d.ts","sourceRoot":"","sources":["../src/ExpoBeaconModule.ts"],"names":[],"mappings":"AA0FA,eAAe,MAAM,CAAC"}

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;AAuEzD,IAAI,CAAC;IACH,qDAAqD;IACrD,IAAI,MAAM,GAAG,mBAAmB,CAAmB,YAAY,CAAC,CAAC;AACnE,CAAC;AAAC,MAAM,CAAC;IACP,MAAM,IAAI,KAAK,CACb,oFAAoF;QAClF,8EAA8E,CACjF,CAAC;AACJ,CAAC;AAED,eAAe,MAAM,CAAC","sourcesContent":["import { NativeModule, requireNativeModule } from \"expo\";\r\n\r\nimport {\r\n  ExpoBeaconModuleEvents,\r\n  BeaconScanResult,\r\n  PairedBeacon,\r\n  NotificationConfig,\r\n  MonitoringOptions,\r\n} from \"./ExpoBeacon.types\";\r\n\r\ndeclare class ExpoBeaconModule extends NativeModule<ExpoBeaconModuleEvents> {\r\n  /**\r\n   * Start a one-shot BLE scan. Resolves with discovered beacons after scanDuration ms.\r\n   * @param scanDuration Duration in ms (default 5000)\r\n   */\r\n  scanForBeaconsAsync(scanDuration?: number): Promise<BeaconScanResult[]>;\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  ): 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   * 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  /** Request Bluetooth + Location permissions. Returns true if granted. */\r\n  requestPermissionsAsync(): Promise<boolean>;\r\n}\r\n\r\ntry {\r\n  // eslint-disable-next-line import/no-mutable-exports\r\n  var module = requireNativeModule<ExpoBeaconModule>(\"ExpoBeacon\");\r\n} catch {\r\n  throw new Error(\r\n    \"expo-beacon: native module not found. Make sure you are using a development build \" +\r\n      \"(not Expo Go) and have run `npx expo prebuild` followed by a native rebuild.\",\r\n  );\r\n}\r\n\r\nexport default module;\r\n"]}
+{"version":3,"file":"ExpoBeaconModule.js","sourceRoot":"","sources":["../src/ExpoBeaconModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAgFzD,IAAI,CAAC;IACH,qDAAqD;IACrD,IAAI,MAAM,GAAG,mBAAmB,CAAmB,YAAY,CAAC,CAAC;AACnE,CAAC;AAAC,MAAM,CAAC;IACP,MAAM,IAAI,KAAK,CACb,oFAAoF;QAClF,8EAA8E,CACjF,CAAC;AACJ,CAAC;AAED,eAAe,MAAM,CAAC","sourcesContent":["import { NativeModule, requireNativeModule } from \"expo\";\r\n\r\nimport {\r\n  ExpoBeaconModuleEvents,\r\n  BeaconScanResult,\r\n  PairedBeacon,\r\n  NotificationConfig,\r\n  MonitoringOptions,\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   * Pass an empty array or omit to perform a wildcard scan that discovers all nearby\r\n   * iBeacons (uses CoreBluetooth on iOS — foreground only).\r\n   *\r\n   * @param uuids Proximity UUIDs to filter by. Empty/omitted = wildcard scan.\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   * 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  ): 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   * 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  /** Request Bluetooth + Location permissions. Returns true if granted. */\r\n  requestPermissionsAsync(): Promise<boolean>;\r\n}\r\n\r\ntry {\r\n  // eslint-disable-next-line import/no-mutable-exports\r\n  var module = requireNativeModule<ExpoBeaconModule>(\"ExpoBeacon\");\r\n} catch {\r\n  throw new Error(\r\n    \"expo-beacon: native module not found. Make sure you are using a development build \" +\r\n      \"(not Expo Go) and have run `npx expo prebuild` followed by a native rebuild.\",\r\n  );\r\n}\r\n\r\nexport default module;\r\n"]}

package/build/ExpoBeaconModule.web.d.ts

@@ -1,6 +1,6 @@
 import type { ExpoBeaconModuleEvents, BeaconScanResult, PairedBeacon } from "./ExpoBeacon.types";
 declare const stub: {
-    scanForBeaconsAsync: (_scanDuration?: number) => Promise<BeaconScanResult[]>;
+    scanForBeaconsAsync: (_uuids: string[], _scanDuration?: number) => Promise<BeaconScanResult[]>;
     pairBeacon: (_identifier: string, _uuid: string, _major: number, _minor: number) => void;
     unpairBeacon: (_identifier: string) => void;
     getPairedBeacons: () => PairedBeacon[];

package/build/ExpoBeaconModule.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoBeaconModule.web.d.ts","sourceRoot":"","sources":["../src/ExpoBeaconModule.web.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,gBAAgB,EAChB,YAAY,EACb,MAAM,oBAAoB,CAAC;AAM5B,QAAA,MAAM,IAAI;0CAC8B,MAAM,KAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;8BAG3D,MAAM,SACZ,MAAM,UACL,MAAM,UACN,MAAM,KACb,IAAI;gCACqB,MAAM,KAAG,IAAI;4BACnB,YAAY,EAAE;2BACf,OAAO,CAAC,IAAI,CAAC;0BACd,OAAO,CAAC,IAAI,CAAC;mCACJ,OAAO,CAAC,OAAO,CAAC;8BACnB,MAAM,sBAAsB,aAAa,GAAG;;;qCAGrC,MAAM,sBAAsB;CAC9D,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"ExpoBeaconModule.web.d.ts","sourceRoot":"","sources":["../src/ExpoBeaconModule.web.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,gBAAgB,EAChB,YAAY,EACb,MAAM,oBAAoB,CAAC;AAM5B,QAAA,MAAM,IAAI;kCAEE,MAAM,EAAE,kBACA,MAAM,KACrB,OAAO,CAAC,gBAAgB,EAAE,CAAC;8BAEf,MAAM,SACZ,MAAM,UACL,MAAM,UACN,MAAM,KACb,IAAI;gCACqB,MAAM,KAAG,IAAI;4BACnB,YAAY,EAAE;2BACf,OAAO,CAAC,IAAI,CAAC;0BACd,OAAO,CAAC,IAAI,CAAC;mCACJ,OAAO,CAAC,OAAO,CAAC;8BACnB,MAAM,sBAAsB,aAAa,GAAG;;;qCAGrC,MAAM,sBAAsB;CAC9D,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/build/ExpoBeaconModule.web.js

@@ -2,7 +2,7 @@ const notSupported = () => {
     throw new Error("expo-beacon is not supported on web.");
 };
 const stub = {
-    scanForBeaconsAsync: (_scanDuration) => notSupported(),
+    scanForBeaconsAsync: (_uuids, _scanDuration) => notSupported(),
     pairBeacon: (_identifier, _uuid, _major, _minor) => notSupported(),
     unpairBeacon: (_identifier) => notSupported(),
     getPairedBeacons: () => notSupported(),

package/build/ExpoBeaconModule.web.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoBeaconModule.web.js","sourceRoot":"","sources":["../src/ExpoBeaconModule.web.ts"],"names":[],"mappings":"AAMA,MAAM,YAAY,GAAG,GAAU,EAAE;IAC/B,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;AAC1D,CAAC,CAAC;AAEF,MAAM,IAAI,GAAG;IACX,mBAAmB,EAAE,CAAC,aAAsB,EAA+B,EAAE,CAC3E,YAAY,EAAE;IAChB,UAAU,EAAE,CACV,WAAmB,EACnB,KAAa,EACb,MAAc,EACd,MAAc,EACR,EAAE,CAAC,YAAY,EAAE;IACzB,YAAY,EAAE,CAAC,WAAmB,EAAQ,EAAE,CAAC,YAAY,EAAE;IAC3D,gBAAgB,EAAE,GAAmB,EAAE,CAAC,YAAY,EAAE;IACtD,eAAe,EAAE,GAAkB,EAAE,CAAC,YAAY,EAAE;IACpD,cAAc,EAAE,GAAkB,EAAE,CAAC,YAAY,EAAE;IACnD,uBAAuB,EAAE,GAAqB,EAAE,CAAC,YAAY,EAAE;IAC/D,WAAW,EAAE,CAAC,UAAwC,EAAE,SAAc,EAAE,EAAE,CAAC,CAAC;QAC1E,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC;KACjB,CAAC;IACF,kBAAkB,EAAE,CAAC,UAAwC,EAAE,EAAE,GAAE,CAAC;CACrE,CAAC;AAEF,eAAe,IAAI,CAAC","sourcesContent":["import type {\r\n  ExpoBeaconModuleEvents,\r\n  BeaconScanResult,\r\n  PairedBeacon,\r\n} from \"./ExpoBeacon.types\";\r\n\r\nconst notSupported = (): never => {\r\n  throw new Error(\"expo-beacon is not supported on web.\");\r\n};\r\n\r\nconst stub = {\r\n  scanForBeaconsAsync: (_scanDuration?: number): Promise<BeaconScanResult[]> =>\r\n    notSupported(),\r\n  pairBeacon: (\r\n    _identifier: string,\r\n    _uuid: string,\r\n    _major: number,\r\n    _minor: number,\r\n  ): void => notSupported(),\r\n  unpairBeacon: (_identifier: string): void => notSupported(),\r\n  getPairedBeacons: (): PairedBeacon[] => notSupported(),\r\n  startMonitoring: (): Promise<void> => notSupported(),\r\n  stopMonitoring: (): Promise<void> => notSupported(),\r\n  requestPermissionsAsync: (): Promise<boolean> => notSupported(),\r\n  addListener: (_eventName: keyof ExpoBeaconModuleEvents, _listener: any) => ({\r\n    remove: () => {},\r\n  }),\r\n  removeAllListeners: (_eventName: keyof ExpoBeaconModuleEvents) => {},\r\n};\r\n\r\nexport default stub;\r\n"]}
+{"version":3,"file":"ExpoBeaconModule.web.js","sourceRoot":"","sources":["../src/ExpoBeaconModule.web.ts"],"names":[],"mappings":"AAMA,MAAM,YAAY,GAAG,GAAU,EAAE;IAC/B,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;AAC1D,CAAC,CAAC;AAEF,MAAM,IAAI,GAAG;IACX,mBAAmB,EAAE,CACnB,MAAgB,EAChB,aAAsB,EACO,EAAE,CAAC,YAAY,EAAE;IAChD,UAAU,EAAE,CACV,WAAmB,EACnB,KAAa,EACb,MAAc,EACd,MAAc,EACR,EAAE,CAAC,YAAY,EAAE;IACzB,YAAY,EAAE,CAAC,WAAmB,EAAQ,EAAE,CAAC,YAAY,EAAE;IAC3D,gBAAgB,EAAE,GAAmB,EAAE,CAAC,YAAY,EAAE;IACtD,eAAe,EAAE,GAAkB,EAAE,CAAC,YAAY,EAAE;IACpD,cAAc,EAAE,GAAkB,EAAE,CAAC,YAAY,EAAE;IACnD,uBAAuB,EAAE,GAAqB,EAAE,CAAC,YAAY,EAAE;IAC/D,WAAW,EAAE,CAAC,UAAwC,EAAE,SAAc,EAAE,EAAE,CAAC,CAAC;QAC1E,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC;KACjB,CAAC;IACF,kBAAkB,EAAE,CAAC,UAAwC,EAAE,EAAE,GAAE,CAAC;CACrE,CAAC;AAEF,eAAe,IAAI,CAAC","sourcesContent":["import type {\r\n  ExpoBeaconModuleEvents,\r\n  BeaconScanResult,\r\n  PairedBeacon,\r\n} from \"./ExpoBeacon.types\";\r\n\r\nconst notSupported = (): never => {\r\n  throw new Error(\"expo-beacon is not supported on web.\");\r\n};\r\n\r\nconst stub = {\r\n  scanForBeaconsAsync: (\r\n    _uuids: string[],\r\n    _scanDuration?: number,\r\n  ): Promise<BeaconScanResult[]> => notSupported(),\r\n  pairBeacon: (\r\n    _identifier: string,\r\n    _uuid: string,\r\n    _major: number,\r\n    _minor: number,\r\n  ): void => notSupported(),\r\n  unpairBeacon: (_identifier: string): void => notSupported(),\r\n  getPairedBeacons: (): PairedBeacon[] => notSupported(),\r\n  startMonitoring: (): Promise<void> => notSupported(),\r\n  stopMonitoring: (): Promise<void> => notSupported(),\r\n  requestPermissionsAsync: (): Promise<boolean> => notSupported(),\r\n  addListener: (_eventName: keyof ExpoBeaconModuleEvents, _listener: any) => ({\r\n    remove: () => {},\r\n  }),\r\n  removeAllListeners: (_eventName: keyof ExpoBeaconModuleEvents) => {},\r\n};\r\n\r\nexport default stub;\r\n"]}

package/build/index.d.ts

@@ -1,3 +1,3 @@
 export { default } from "./ExpoBeaconModule";
-export type { BeaconScanResult, PairedBeacon, BeaconRegionEvent, BeaconRangingEvent, BeaconDistanceEvent, ExpoBeaconModuleEvents, NotificationConfig, MonitoringOptions, BeaconNotificationConfig, ForegroundServiceConfig, NotificationChannelConfig, } from "./ExpoBeacon.types";
+export type { BeaconScanResult, PairedBeacon, BeaconRegionEvent, BeaconDistanceEvent, ExpoBeaconModuleEvents, NotificationConfig, MonitoringOptions, BeaconNotificationConfig, ForegroundServiceConfig, NotificationChannelConfig, } from "./ExpoBeacon.types";
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG7C,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG7C,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC"}

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC","sourcesContent":["// Native module (default export)\r\nexport { default } from \"./ExpoBeaconModule\";\r\n\r\n// All public types\r\nexport type {\r\n  BeaconScanResult,\r\n  PairedBeacon,\r\n  BeaconRegionEvent,\r\n  BeaconRangingEvent,\r\n  BeaconDistanceEvent,\r\n  ExpoBeaconModuleEvents,\r\n  NotificationConfig,\r\n  MonitoringOptions,\r\n  BeaconNotificationConfig,\r\n  ForegroundServiceConfig,\r\n  NotificationChannelConfig,\r\n} from \"./ExpoBeacon.types\";\r\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC","sourcesContent":["// Native module (default export)\r\nexport { default } from \"./ExpoBeaconModule\";\r\n\r\n// All public types\r\nexport type {\r\n  BeaconScanResult,\r\n  PairedBeacon,\r\n  BeaconRegionEvent,\r\n  BeaconDistanceEvent,\r\n  ExpoBeaconModuleEvents,\r\n  NotificationConfig,\r\n  MonitoringOptions,\r\n  BeaconNotificationConfig,\r\n  ForegroundServiceConfig,\r\n  NotificationChannelConfig,\r\n} from \"./ExpoBeacon.types\";\r\n"]}

package/ios/ExpoBeacon.podspec

@@ -19,7 +19,7 @@ Pod::Spec.new do |s|
 
   s.dependency 'ExpoModulesCore'
 
-  # Required system frameworks for iBeacon monitoring
+  # Required system frameworks for iBeacon monitoring + wildcard BLE scanning
   s.frameworks = 'CoreLocation', 'CoreBluetooth', 'UserNotifications'
 
   # Swift/Objective-C compatibility