expo-beacon 0.4.0 → 0.4.1

package/README.md

@@ -48,9 +48,9 @@ In Xcode under **Signing & Capabilities**, enable:
 
 > iOS limits apps to **20 simultaneously monitored regions** (iBeacon only — Eddystone beacons are monitored via BLE and do not count toward this limit).
 >
-> **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.
+> **iBeacon scanning on iOS**: Apple strips iBeacon manufacturer data from CoreBluetooth BLE advertisements, so wildcard iBeacon discovery is **not possible** on iOS. You must provide at least one proximity UUID, or pair beacons first (the module will use paired beacon UUIDs automatically). UUID-targeted scans use CoreLocation ranging and work in both foreground and background.
 >
-> **Eddystone scanning**: Eddystone beacons use standard BLE service data (UUID `0xFEAA`), which iOS does not filter. `scanForEddystonesAsync()` and continuous scanning work in the foreground on both platforms.
+> **Eddystone scanning**: Eddystone beacons use standard BLE service data (UUID `0xFEAA`), which iOS does not filter. `scanForEddystonesAsync()` and continuous scanning discover Eddystones on both platforms without restrictions.
 
 ### Android
 
@@ -203,30 +203,30 @@ Starts a **one-shot BLE scan**, waits for `scanDurationMs` milliseconds, then re
 
 | Parameter        | Type       | Default | Description                              |
 | ---------------- | ---------- | ------- | ---------------------------------------- |
-| `uuids`          | `string[]` | `[]`    | Proximity UUIDs to filter by. Pass `[]` or omit for a **wildcard scan** that discovers all nearby iBeacons. |
+| `uuids`          | `string[]` | `[]`    | Proximity UUIDs to filter by. **iOS**: at least one UUID is required (or have paired beacons). **Android**: pass `[]` for a wildcard scan. |
 | `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**
+**Platform differences**
 
-| | Wildcard (`[]` / omitted) | Targeted (`['UUID-1', …]`) |
+| | Empty UUIDs (`[]`) | 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** | Uses paired beacon UUIDs automatically. Rejects if no UUIDs and no paired beacons. | CoreLocation ranging (works in foreground & 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.
+> **iOS limitation**: Apple strips iBeacon manufacturer data from CoreBluetooth BLE advertisements. Wildcard iBeacon scanning (no UUID filter) is not possible on iOS. When you pass an empty `uuids` array, the module automatically uses UUIDs from your paired beacons. If no beacons are paired, the call rejects with `WILDCARD_NOT_SUPPORTED`. For Eddystone scanning, use `scanForEddystonesAsync()` instead — it works without restrictions on both platforms.
 
 ```ts
-// Wildcard scan — discover all nearby iBeacons
-const all = await ExpoBeacon.scanForBeaconsAsync([], 5000);
-
-// Targeted scan — only beacons matching these UUIDs
+// Scan by UUID — works on both platforms
 const filtered = await ExpoBeacon.scanForBeaconsAsync(
   ['E2C56DB5-DFFB-48D2-B060-D0F5A71096E0'],
   8000,
 );
 
+// Wildcard scan — Android only. On iOS, uses paired beacon UUIDs.
+const all = await ExpoBeacon.scanForBeaconsAsync([], 5000);
+
 filtered.forEach((b) =>
   console.log(`${b.uuid}  major=${b.major}  minor=${b.minor}  dist=${b.distance.toFixed(1)}m  rssi=${b.rssi}dBm`)
 );

package/build/ExpoBeaconModule.d.ts

@@ -5,10 +5,12 @@ declare class ExpoBeaconModule extends NativeModule<ExpoBeaconModuleEvents> {
      * Start a one-shot iBeacon scan. Resolves with discovered beacons after scanDuration ms.
      *
      * Pass one or more UUIDs to scan for specific beacons (uses CoreLocation on iOS).
-     * Pass an empty array or omit to perform a wildcard scan that discovers all nearby
-     * iBeacons (uses CoreBluetooth on iOS — foreground only).
+     * On iOS, at least one UUID is required — Apple strips iBeacon data from BLE
+     * advertisements, making wildcard discovery impossible. When you pass an empty
+     * array, the module automatically uses UUIDs from paired beacons.
+     * On Android, pass an empty array to discover all nearby iBeacons.
      *
-     * @param uuids Proximity UUIDs to filter by. Empty/omitted = wildcard scan.
+     * @param uuids Proximity UUIDs to filter by. Empty/omitted = use paired UUIDs (iOS) or wildcard (Android).
      * @param scanDuration Duration in ms (default 5000)
      */
     scanForBeaconsAsync(uuids?: string[], scanDuration?: number): Promise<BeaconScanResult[]>;

package/build/ExpoBeaconModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoBeaconModule.d.ts","sourceRoot":"","sources":["../src/ExpoBeaconModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,MAAM,CAAC;AAEzD,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,OAAO,gBAAiB,SAAQ,YAAY,CAAC,sBAAsB,CAAC;IACzE;;;;;;;;;OASG;IACH,mBAAmB,CACjB,KAAK,CAAC,EAAE,MAAM,EAAE,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAE9B;;;;;OAKG;IACH,sBAAsB,CACpB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAEjC;;OAEG;IACH,UAAU,CACR,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,IAAI;IAEP;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAEtC;;OAEG;IACH,gBAAgB,IAAI,YAAY,EAAE;IAElC;;OAEG;IACH,aAAa,CACX,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,IAAI;IAEP;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAEzC;;OAEG;IACH,mBAAmB,IAAI,eAAe,EAAE;IAExC;;;OAGG;IACH,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAEvD;;;;;;;OAOG;IACH,eAAe,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAEpE;;OAEG;IACH,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAE/B;;;OAGG;IACH,mBAAmB,IAAI,IAAI;IAE3B,iEAAiE;IACjE,kBAAkB,IAAI,IAAI;IAE1B,yEAAyE;IACzE,uBAAuB,IAAI,OAAO,CAAC,OAAO,CAAC;CAC5C;;AAED,wBAAmE"}
+{"version":3,"file":"ExpoBeaconModule.d.ts","sourceRoot":"","sources":["../src/ExpoBeaconModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,MAAM,CAAC;AAEzD,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,OAAO,gBAAiB,SAAQ,YAAY,CAAC,sBAAsB,CAAC;IACzE;;;;;;;;;;;OAWG;IACH,mBAAmB,CACjB,KAAK,CAAC,EAAE,MAAM,EAAE,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAE9B;;;;;OAKG;IACH,sBAAsB,CACpB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAEjC;;OAEG;IACH,UAAU,CACR,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,IAAI;IAEP;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAEtC;;OAEG;IACH,gBAAgB,IAAI,YAAY,EAAE;IAElC;;OAEG;IACH,aAAa,CACX,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,IAAI;IAEP;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAEzC;;OAEG;IACH,mBAAmB,IAAI,eAAe,EAAE;IAExC;;;OAGG;IACH,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAEvD;;;;;;;OAOG;IACH,eAAe,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAEpE;;OAEG;IACH,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAE/B;;;OAGG;IACH,mBAAmB,IAAI,IAAI;IAE3B,iEAAiE;IACjE,kBAAkB,IAAI,IAAI;IAE1B,yEAAyE;IACzE,uBAAuB,IAAI,OAAO,CAAC,OAAO,CAAC;CAC5C;;AAED,wBAAmE"}

package/build/ExpoBeaconModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoBeaconModule.js","sourceRoot":"","sources":["../src/ExpoBeaconModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,mBAAmB,EAAE,MAAM,MAAM,CAAC;AA+GzD,eAAe,mBAAmB,CAAmB,YAAY,CAAC,CAAC","sourcesContent":["import { NativeModule, requireNativeModule } from \"expo\";\r\n\r\nimport {\r\n  ExpoBeaconModuleEvents,\r\n  BeaconScanResult,\r\n  EddystoneScanResult,\r\n  PairedBeacon,\r\n  PairedEddystone,\r\n  NotificationConfig,\r\n  MonitoringOptions,\r\n} 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   * Start a one-shot Eddystone beacon scan using BLE.\r\n   * Discovers Eddystone-UID and Eddystone-URL frames.\r\n   *\r\n   * @param scanDuration Duration in ms (default 5000)\r\n   */\r\n  scanForEddystonesAsync(\r\n    scanDuration?: number,\r\n  ): Promise<EddystoneScanResult[]>;\r\n\r\n  /**\r\n   * Register a beacon for persistent region monitoring.\r\n   */\r\n  pairBeacon(\r\n    identifier: string,\r\n    uuid: string,\r\n    major: number,\r\n    minor: number,\r\n  ): void;\r\n\r\n  /**\r\n   * Remove a previously paired beacon.\r\n   */\r\n  unpairBeacon(identifier: string): void;\r\n\r\n  /**\r\n   * Return all currently paired beacons.\r\n   */\r\n  getPairedBeacons(): PairedBeacon[];\r\n\r\n  /**\r\n   * Register an Eddystone-UID beacon for persistent monitoring.\r\n   */\r\n  pairEddystone(\r\n    identifier: string,\r\n    namespace: string,\r\n    instance: string,\r\n  ): void;\r\n\r\n  /**\r\n   * Remove a previously paired Eddystone beacon.\r\n   */\r\n  unpairEddystone(identifier: string): void;\r\n\r\n  /**\r\n   * Return all currently paired Eddystone beacons.\r\n   */\r\n  getPairedEddystones(): PairedEddystone[];\r\n\r\n  /**\r\n   * Set persistent notification configuration. Settings are saved and applied to all\r\n   * subsequent monitoring sessions until explicitly changed.\r\n   */\r\n  setNotificationConfig(config: NotificationConfig): void;\r\n\r\n  /**\r\n   * Start background region monitoring for all paired beacons.\r\n   * On Android starts a foreground service.\r\n   * On iOS starts CLLocationManager region monitoring.\r\n   *\r\n   * Accepts a plain number (backward-compatible maxDistance shorthand) or a\r\n   * MonitoringOptions object with maxDistance and/or notification overrides.\r\n   */\r\n  startMonitoring(options?: MonitoringOptions | number): Promise<void>;\r\n\r\n  /**\r\n   * Stop background region monitoring.\r\n   */\r\n  stopMonitoring(): Promise<void>;\r\n\r\n  /**\r\n   * Start a continuous BLE scan. Fires `onBeaconFound` events as beacons are detected.\r\n   * Call stopContinuousScan() to end the scan.\r\n   */\r\n  startContinuousScan(): void;\r\n\r\n  /** Stop the continuous scan started by startContinuousScan(). */\r\n  stopContinuousScan(): void;\r\n\r\n  /** Request Bluetooth + Location permissions. Returns true if granted. */\r\n  requestPermissionsAsync(): Promise<boolean>;\r\n}\r\n\r\nexport default requireNativeModule<ExpoBeaconModule>(\"ExpoBeacon\");\r\n"]}
+{"version":3,"file":"ExpoBeaconModule.js","sourceRoot":"","sources":["../src/ExpoBeaconModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAiHzD,eAAe,mBAAmB,CAAmB,YAAY,CAAC,CAAC","sourcesContent":["import { NativeModule, requireNativeModule } from \"expo\";\r\n\r\nimport {\r\n  ExpoBeaconModuleEvents,\r\n  BeaconScanResult,\r\n  EddystoneScanResult,\r\n  PairedBeacon,\r\n  PairedEddystone,\r\n  NotificationConfig,\r\n  MonitoringOptions,\r\n} from \"./ExpoBeacon.types\";\r\n\r\ndeclare class ExpoBeaconModule extends NativeModule<ExpoBeaconModuleEvents> {\r\n  /**\r\n   * Start a one-shot iBeacon scan. Resolves with discovered beacons after scanDuration ms.\r\n   *\r\n   * Pass one or more UUIDs to scan for specific beacons (uses CoreLocation on iOS).\r\n   * On iOS, at least one UUID is required — Apple strips iBeacon data from BLE\r\n   * advertisements, making wildcard discovery impossible. When you pass an empty\r\n   * array, the module automatically uses UUIDs from paired beacons.\r\n   * On Android, pass an empty array to discover all nearby iBeacons.\r\n   *\r\n   * @param uuids Proximity UUIDs to filter by. Empty/omitted = use paired UUIDs (iOS) or wildcard (Android).\r\n   * @param scanDuration Duration in ms (default 5000)\r\n   */\r\n  scanForBeaconsAsync(\r\n    uuids?: string[],\r\n    scanDuration?: number,\r\n  ): Promise<BeaconScanResult[]>;\r\n\r\n  /**\r\n   * Start a one-shot Eddystone beacon scan using BLE.\r\n   * Discovers Eddystone-UID and Eddystone-URL frames.\r\n   *\r\n   * @param scanDuration Duration in ms (default 5000)\r\n   */\r\n  scanForEddystonesAsync(\r\n    scanDuration?: number,\r\n  ): Promise<EddystoneScanResult[]>;\r\n\r\n  /**\r\n   * Register a beacon for persistent region monitoring.\r\n   */\r\n  pairBeacon(\r\n    identifier: string,\r\n    uuid: string,\r\n    major: number,\r\n    minor: number,\r\n  ): void;\r\n\r\n  /**\r\n   * Remove a previously paired beacon.\r\n   */\r\n  unpairBeacon(identifier: string): void;\r\n\r\n  /**\r\n   * Return all currently paired beacons.\r\n   */\r\n  getPairedBeacons(): PairedBeacon[];\r\n\r\n  /**\r\n   * Register an Eddystone-UID beacon for persistent monitoring.\r\n   */\r\n  pairEddystone(\r\n    identifier: string,\r\n    namespace: string,\r\n    instance: string,\r\n  ): void;\r\n\r\n  /**\r\n   * Remove a previously paired Eddystone beacon.\r\n   */\r\n  unpairEddystone(identifier: string): void;\r\n\r\n  /**\r\n   * Return all currently paired Eddystone beacons.\r\n   */\r\n  getPairedEddystones(): PairedEddystone[];\r\n\r\n  /**\r\n   * Set persistent notification configuration. Settings are saved and applied to all\r\n   * subsequent monitoring sessions until explicitly changed.\r\n   */\r\n  setNotificationConfig(config: NotificationConfig): void;\r\n\r\n  /**\r\n   * Start background region monitoring for all paired beacons.\r\n   * On Android starts a foreground service.\r\n   * On iOS starts CLLocationManager region monitoring.\r\n   *\r\n   * Accepts a plain number (backward-compatible maxDistance shorthand) or a\r\n   * MonitoringOptions object with maxDistance and/or notification overrides.\r\n   */\r\n  startMonitoring(options?: MonitoringOptions | number): Promise<void>;\r\n\r\n  /**\r\n   * Stop background region monitoring.\r\n   */\r\n  stopMonitoring(): Promise<void>;\r\n\r\n  /**\r\n   * Start a continuous BLE scan. Fires `onBeaconFound` events as beacons are detected.\r\n   * Call stopContinuousScan() to end the scan.\r\n   */\r\n  startContinuousScan(): void;\r\n\r\n  /** Stop the continuous scan started by startContinuousScan(). */\r\n  stopContinuousScan(): void;\r\n\r\n  /** Request Bluetooth + Location permissions. Returns true if granted. */\r\n  requestPermissionsAsync(): Promise<boolean>;\r\n}\r\n\r\nexport default requireNativeModule<ExpoBeaconModule>(\"ExpoBeacon\");\r\n"]}

package/ios/ExpoBeaconModule.swift

@@ -52,11 +52,9 @@ public class ExpoBeaconModule: Module {
     // Constraints started exclusively for continuous scan (not shared with distance ranging)
     private var continuousScanOnlyConstraints: [CLBeaconIdentityConstraint] = []
 
-    // Wildcard (CoreBluetooth) scan state
+    // CoreBluetooth scan state (Eddystone + monitoring)
     private lazy var bluetoothDelegate = BluetoothDelegate(module: self)
     private var centralManager: CBCentralManager?
-    private var wildcardScannedBeacons: [[String: Any]] = []
-    private var wildcardScanTimer: DispatchWorkItem?
 
     // Eddystone (CoreBluetooth) scan state
     fileprivate var eddystoneScanPromise: Promise?
@@ -450,89 +448,6 @@ public class ExpoBeaconModule: Module {
         scannedBeacons = []
     }
 
-    // MARK: - Wildcard (CoreBluetooth) scan
-
-    private func startWildcardScan(durationMs: Int) {
-        wildcardScannedBeacons = []
-
-        if centralManager == nil {
-            // Creating CBCentralManager triggers a Bluetooth power-on check.
-            // Once .poweredOn, the delegate calls beginWildcardScanning().
-            centralManager = CBCentralManager(delegate: bluetoothDelegate, queue: .main)
-        } else if centralManager?.state == .poweredOn {
-            beginWildcardScanning()
-        }
-        // If state is not yet .poweredOn the delegate will call beginWildcardScanning()
-        // when centralManagerDidUpdateState fires.
-
-        let timer = DispatchWorkItem { [weak self] in
-            self?.stopWildcardScanAndResolve()
-        }
-        wildcardScanTimer = timer
-        DispatchQueue.main.asyncAfter(deadline: .now() + .milliseconds(durationMs), execute: timer)
-    }
-
-    fileprivate func beginWildcardScanning() {
-        guard scanPromise != nil, wildcardScanTimer != nil else { return }
-        centralManager?.scanForPeripherals(
-            withServices: nil,
-            options: [CBCentralManagerScanOptionAllowDuplicatesKey: true]
-        )
-    }
-
-    fileprivate func handleWildcardDiscovery(advertisementData: [String: Any], rssi: NSNumber) {
-        guard let mfgData = advertisementData[CBAdvertisementDataManufacturerDataKey] as? Data,
-              mfgData.count >= 25 else { return }
-
-        // iBeacon format: Apple company ID (0x4C 0x00) + type 0x02 + length 0x15
-        guard mfgData[0] == 0x4C, mfgData[1] == 0x00,
-              mfgData[2] == 0x02, mfgData[3] == 0x15 else { return }
-
-        // Parse UUID (bytes 4–19)
-        let uuidBytes = [UInt8](mfgData[4..<20])
-        let uuid = NSUUID(uuidBytes: uuidBytes) as UUID
-
-        // Parse major (bytes 20–21, big-endian) and minor (bytes 22–23, big-endian)
-        let major = Int(UInt16(mfgData[20]) << 8 | UInt16(mfgData[21]))
-        let minor = Int(UInt16(mfgData[22]) << 8 | UInt16(mfgData[23]))
-
-        // TX power (byte 24, signed)
-        let txPower = Int(Int8(bitPattern: mfgData[24]))
-
-        let rssiValue = rssi.intValue
-        let distance = Self.calculateDistance(rssi: rssiValue, txPower: txPower)
-
-        let result: [String: Any] = [
-            "uuid": uuid.uuidString.uppercased(),
-            "major": major,
-            "minor": minor,
-            "rssi": rssiValue,
-            "distance": distance,
-            "txPower": txPower
-        ]
-        wildcardScannedBeacons.append(result)
-    }
-
-    private func stopWildcardScanAndResolve() {
-        wildcardScanTimer?.cancel()
-        wildcardScanTimer = nil
-        stopBleScanIfUnneeded()
-
-        // Deduplicate by uuid:major:minor, keeping the last (freshest) reading
-        var seen = Set<String>()
-        var deduped: [[String: Any]] = []
-        for beacon in wildcardScannedBeacons.reversed() {
-            let key = "\(beacon["uuid"] ?? ""):\(beacon["major"] ?? ""):\(beacon["minor"] ?? "")"
-            guard !seen.contains(key) else { continue }
-            seen.insert(key)
-            deduped.append(beacon)
-        }
-
-        scanPromise?.resolve(deduped)
-        scanPromise = nil
-        wildcardScannedBeacons = []
-    }
-
     // MARK: - Eddystone Scan
 
     private func startEddystoneScan(durationMs: Int) {
@@ -727,7 +642,7 @@ public class ExpoBeaconModule: Module {
     }
 
     private func stopBleScanIfUnneeded() {
-        guard wildcardScanTimer == nil && eddystoneScanTimer == nil && !continuousScanActive && !eddystoneMonitoringActive else { return }
+        guard eddystoneScanTimer == nil && !continuousScanActive && !eddystoneMonitoringActive else { return }
         centralManager?.stopScan()
     }
 
@@ -1105,7 +1020,7 @@ private class LocationDelegate: NSObject, CLLocationManagerDelegate {
     }
 }
 
-// MARK: - CBCentralManagerDelegate (wildcard iBeacon scanning)
+// MARK: - CBCentralManagerDelegate (Eddystone BLE scanning)
 
 private class BluetoothDelegate: NSObject, CBCentralManagerDelegate {
     private weak var module: ExpoBeaconModule?
@@ -1137,7 +1052,6 @@ private class BluetoothDelegate: NSObject, CBCentralManagerDelegate {
                          didDiscover peripheral: CBPeripheral,
                          advertisementData: [String: Any],
                          rssi RSSI: NSNumber) {
-        module?.handleWildcardDiscovery(advertisementData: advertisementData, rssi: RSSI)
         module?.handleEddystoneDiscovery(advertisementData: advertisementData, rssi: RSSI)
     }
 }

package/package.json

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

package/src/ExpoBeaconModule.ts

@@ -15,10 +15,12 @@ declare class ExpoBeaconModule extends NativeModule<ExpoBeaconModuleEvents> {
    * Start a one-shot iBeacon scan. Resolves with discovered beacons after scanDuration ms.
    *
    * Pass one or more UUIDs to scan for specific beacons (uses CoreLocation on iOS).
-   * Pass an empty array or omit to perform a wildcard scan that discovers all nearby
-   * iBeacons (uses CoreBluetooth on iOS — foreground only).
+   * On iOS, at least one UUID is required — Apple strips iBeacon data from BLE
+   * advertisements, making wildcard discovery impossible. When you pass an empty
+   * array, the module automatically uses UUIDs from paired beacons.
+   * On Android, pass an empty array to discover all nearby iBeacons.
    *
-   * @param uuids Proximity UUIDs to filter by. Empty/omitted = wildcard scan.
+   * @param uuids Proximity UUIDs to filter by. Empty/omitted = use paired UUIDs (iOS) or wildcard (Android).
    * @param scanDuration Duration in ms (default 5000)
    */
   scanForBeaconsAsync(