expo-beacon 0.7.2 → 0.7.3

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

@@ -0,0 +1,17 @@
+package expo.modules.beacon
+
+/**
+ * Implement this interface in your app to react to beacon enter/exit events at the native level.
+ *
+ * Register your implementation via [BeaconPluginRegistry.register] from MainApplication.onCreate().
+ * Unregister via [BeaconPluginRegistry.unregister] if the plugin has a scoped lifetime.
+ */
+interface BeaconEventPlugin {
+    // iBeacon
+    fun onBeaconEnter(identifier: String, uuid: String, major: Int, minor: Int, distance: Double)
+    fun onBeaconExit(identifier: String, uuid: String, major: Int, minor: Int, distance: Double)
+
+    // Eddystone
+    fun onEddystoneEnter(identifier: String, namespace: String, instance: String, distance: Double)
+    fun onEddystoneExit(identifier: String, namespace: String, instance: String, distance: Double)
+}

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

@@ -614,6 +614,21 @@ class BeaconForegroundService : Service(), BeaconConsumer {
         // Forward all produced events to remote API
         apiForwarder?.forwardEvent(params)
 
+        // Dispatch enter/exit to registered plugins (e.g. to start/stop BGLocation)
+        if (eventType == "enter" || eventType == "exit") {
+            val identifier = region.uniqueId
+            val uuid = if (!isEddystone) id1Str else ""
+            val major = if (!isEddystone) region.id2?.toInt() ?: 0 else 0
+            val minor = if (!isEddystone) region.id3?.toInt() ?: 0 else 0
+            val namespace = if (isEddystone) id1Str.removePrefix("0x") else ""
+            val instance = if (isEddystone) region.id2?.toString()?.removePrefix("0x") ?: "" else ""
+            if (eventType == "enter") {
+                BeaconPluginRegistry.dispatchEnter(isEddystone, identifier, uuid, major, minor, namespace, instance, distance)
+            } else {
+                BeaconPluginRegistry.dispatchExit(isEddystone, identifier, uuid, major, minor, namespace, instance, distance)
+            }
+        }
+
         val intent = Intent(ACTION_BEACON_EVENT).apply {
             putExtra("identifier", region.uniqueId)
             putExtra("event", eventType)

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

@@ -0,0 +1,61 @@
+package expo.modules.beacon
+
+import java.util.concurrent.CopyOnWriteArrayList
+
+/**
+ * Thread-safe singleton registry for [BeaconEventPlugin] implementations.
+ *
+ * Register your plugin once from MainApplication.onCreate():
+ *   BeaconPluginRegistry.register(MyBeaconPlugin(this))
+ *
+ * If no plugins are registered, all dispatch calls are no-ops.
+ */
+object BeaconPluginRegistry {
+    private val plugins = CopyOnWriteArrayList<BeaconEventPlugin>()
+
+    fun register(plugin: BeaconEventPlugin) {
+        plugins.add(plugin)
+    }
+
+    fun unregister(plugin: BeaconEventPlugin) {
+        plugins.remove(plugin)
+    }
+
+    internal fun dispatchEnter(
+        isEddystone: Boolean,
+        identifier: String,
+        uuid: String,
+        major: Int,
+        minor: Int,
+        namespace: String,
+        instance: String,
+        distance: Double,
+    ) {
+        plugins.forEach { plugin ->
+            if (isEddystone) {
+                plugin.onEddystoneEnter(identifier, namespace, instance, distance)
+            } else {
+                plugin.onBeaconEnter(identifier, uuid, major, minor, distance)
+            }
+        }
+    }
+
+    internal fun dispatchExit(
+        isEddystone: Boolean,
+        identifier: String,
+        uuid: String,
+        major: Int,
+        minor: Int,
+        namespace: String,
+        instance: String,
+        distance: Double,
+    ) {
+        plugins.forEach { plugin ->
+            if (isEddystone) {
+                plugin.onEddystoneExit(identifier, namespace, instance, distance)
+            } else {
+                plugin.onBeaconExit(identifier, uuid, major, minor, distance)
+            }
+        }
+    }
+}

package/ios/BeaconLifecycleDelegate.swift

@@ -0,0 +1,54 @@
+/// Implement this protocol in your app to react to beacon enter/exit events at the native level.
+///
+/// Register your implementation once, before the Expo module is created:
+///   BeaconLifecycleRegistry.register(MyPlugin())
+///
+/// The registry holds a strong reference — register early (e.g. AppDelegate.didFinishLaunching
+/// before super, or in a +load / initialize method).
+public protocol BeaconLifecycleDelegate: AnyObject {
+    // MARK: iBeacon
+    func beaconDidEnter(identifier: String, uuid: String, major: Int, minor: Int, distance: Double)
+    func beaconDidExit(identifier: String, uuid: String, major: Int, minor: Int, distance: Double)
+
+    // MARK: Eddystone
+    func eddystoneDidEnter(identifier: String, namespace: String, instance: String, distance: Double)
+    func eddystoneDidExit(identifier: String, namespace: String, instance: String, distance: Double)
+}
+
+/// Thread-safe registry for [BeaconLifecycleDelegate] plugins.
+/// Mirrors the Android BeaconPluginRegistry pattern so both platforms use the same app-side wiring.
+public final class BeaconLifecycleRegistry {
+    public static let shared = BeaconLifecycleRegistry()
+    private init() {}
+
+    private let lock = NSLock()
+    private var plugins: [any BeaconLifecycleDelegate] = []
+
+    public static func register(_ plugin: any BeaconLifecycleDelegate) {
+        shared.lock.lock(); defer { shared.lock.unlock() }
+        shared.plugins.append(plugin)
+    }
+
+    public static func unregister(_ plugin: any BeaconLifecycleDelegate) {
+        shared.lock.lock(); defer { shared.lock.unlock() }
+        shared.plugins.removeAll { $0 === plugin }
+    }
+
+    internal func dispatchEnter(identifier: String, uuid: String, major: Int, minor: Int, distance: Double) {
+        snapshot().forEach { $0.beaconDidEnter(identifier: identifier, uuid: uuid, major: major, minor: minor, distance: distance) }
+    }
+    internal func dispatchExit(identifier: String, uuid: String, major: Int, minor: Int, distance: Double) {
+        snapshot().forEach { $0.beaconDidExit(identifier: identifier, uuid: uuid, major: major, minor: minor, distance: distance) }
+    }
+    internal func dispatchEddystoneEnter(identifier: String, namespace: String, instance: String, distance: Double) {
+        snapshot().forEach { $0.eddystoneDidEnter(identifier: identifier, namespace: namespace, instance: instance, distance: distance) }
+    }
+    internal func dispatchEddystoneExit(identifier: String, namespace: String, instance: String, distance: Double) {
+        snapshot().forEach { $0.eddystoneDidExit(identifier: identifier, namespace: namespace, instance: instance, distance: distance) }
+    }
+
+    private func snapshot() -> [any BeaconLifecycleDelegate] {
+        lock.lock(); defer { lock.unlock() }
+        return plugins
+    }
+}

package/ios/ExpoBeaconModule.swift

@@ -123,6 +123,8 @@ public class ExpoBeaconModule: Module {
     private var eventLogger: BeaconEventLogger?
     private var loggingEnabled = false
 
+
+
     // Native API forwarder (fire-and-forget HTTP)
     private lazy var apiForwarder = BeaconApiForwarder(defaults: defaults)
 
@@ -1038,9 +1040,51 @@ public class ExpoBeaconModule: Module {
         }
         // Forward all produced events to remote API
         apiForwarder.forwardEvent(params)
+        // Dispatch enter/exit to registered plugins (e.g. to start/stop BGLocation)
+        dispatchToLifecycleRegistry(eventName: eventName, params: params)
         sendEvent(eventName, params)
     }
 
+    private func dispatchToLifecycleRegistry(eventName: String, params: [String: Any]) {
+        let r = BeaconLifecycleRegistry.shared
+        let identifier = params["identifier"] as? String ?? ""
+        let distance = params["distance"] as? Double ?? -1.0
+        switch eventName {
+        case "onBeaconEnter":
+            r.dispatchEnter(
+                identifier: identifier,
+                uuid: params["uuid"] as? String ?? "",
+                major: params["major"] as? Int ?? 0,
+                minor: params["minor"] as? Int ?? 0,
+                distance: distance
+            )
+        case "onBeaconExit":
+            r.dispatchExit(
+                identifier: identifier,
+                uuid: params["uuid"] as? String ?? "",
+                major: params["major"] as? Int ?? 0,
+                minor: params["minor"] as? Int ?? 0,
+                distance: distance
+            )
+        case "onEddystoneEnter":
+            r.dispatchEddystoneEnter(
+                identifier: identifier,
+                namespace: params["namespace"] as? String ?? "",
+                instance: params["instance"] as? String ?? "",
+                distance: distance
+            )
+        case "onEddystoneExit":
+            r.dispatchEddystoneExit(
+                identifier: identifier,
+                namespace: params["namespace"] as? String ?? "",
+                instance: params["instance"] as? String ?? "",
+                distance: distance
+            )
+        default:
+            break
+        }
+    }
+
     private func getOrCreateEventLogger() -> BeaconEventLogger {
         if let logger = eventLogger {
             return logger

package/package.json

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