expo-beacon 0.7.26 → 0.8.0

package/README.md

@@ -687,6 +687,56 @@ try {
 
 ---
 
+### CarPlay / Android Auto Detection
+
+Detect when the device connects to a car infotainment system and react in JS — or, when the bundled config plugin is installed, automatically start `react-native-background-geolocation` tracking on connect and stop it on disconnect.
+
+Detection covers both **wired and wireless CarPlay** on iOS and **Android Auto projection / Android Automotive OS** on Android. No special CarPlay entitlement or Android Auto certification is required.
+
+```ts
+import ExpoBeacon, {
+  CarPlayConnectedEvent,
+  CarPlayDisconnectedEvent,
+} from "expo-beacon";
+
+// Start observing
+await ExpoBeacon.startCarPlayMonitoring();
+
+const connectSub = ExpoBeacon.addListener(
+  "onCarPlayConnected",
+  (event: CarPlayConnectedEvent) => {
+    // event.transport: "wired" | "wireless" | "projection" | "native" | "unknown"
+    console.log(`Car connected via ${event.transport}`);
+  },
+);
+const disconnectSub = ExpoBeacon.addListener(
+  "onCarPlayDisconnected",
+  (_event: CarPlayDisconnectedEvent) => {
+    console.log("Car disconnected");
+  },
+);
+
+// Stop later (e.g. when feature is disabled)
+await ExpoBeacon.stopCarPlayMonitoring();
+connectSub.remove();
+disconnectSub.remove();
+```
+
+**How it works**
+
+- **iOS:** observes `AVAudioSession.routeChangeNotification` for output ports of type `.carAudio`. Wired-vs-wireless is reported on a best-effort basis (looking for a coexisting Bluetooth output port).
+- **Android:** observes `androidx.car.app.connection.CarConnection` LiveData. `transport` is `"projection"` for phones casting to a head unit, `"native"` for Android Automotive OS.
+- Connect/disconnect events flow through the same SQLite event log and remote API forwarder as beacon events.
+- When the config plugin is installed, the auto-generated `BeaconGeoPlugin` also calls `BackgroundGeolocation.start()` on connect and `.stop()` on disconnect — no extra wiring required.
+
+**Notes**
+
+- `startCarPlayMonitoring()` is idempotent. Calling it twice does not register a duplicate observer.
+- The iOS detector does not require the CarPlay entitlement because it only reads the active audio route; you do not need to ship a CarPlay app.
+- On iOS, if the JS bundle is suspended in the background, the JS event delivery is deferred until the app resumes, but the native lifecycle delegate (used by the geolocation plugin) fires immediately on connect.
+
+---
+
 ## Full API Reference
 
 ### `requestPermissionsAsync()`

package/android/build.gradle

@@ -20,4 +20,7 @@ android {
 
 dependencies {
   implementation 'org.altbeacon:android-beacon-library:2.21.2'
+  // androidx.car.app provides CarConnection LiveData for detecting Android Auto sessions.
+  // No Android Auto certification or extra permissions required for read-only state.
+  implementation 'androidx.car.app:app:1.4.0'
 }

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

@@ -16,4 +16,10 @@ interface BeaconEventPlugin {
     fun onEddystoneEnter(identifier: String, namespace: String, instance: String, distance: Double)
     fun onEddystoneExit(identifier: String, namespace: String, instance: String, distance: Double)
     fun onEddystoneTimeout(identifier: String, namespace: String, instance: String, distance: Double)
+
+    // CarPlay / Android Auto
+    /** Called when the device connects to an Android Auto session. Default no-op. */
+    fun onCarPlayConnected(transport: String) {}
+    /** Called when the device disconnects from an Android Auto session. Default no-op. */
+    fun onCarPlayDisconnected() {}
 }

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

@@ -77,4 +77,12 @@ object BeaconPluginRegistry {
             }
         }
     }
+
+    internal fun dispatchCarPlayConnected(transport: String) {
+        plugins.forEach { it.onCarPlayConnected(transport) }
+    }
+
+    internal fun dispatchCarPlayDisconnected() {
+        plugins.forEach { it.onCarPlayDisconnected() }
+    }
 }

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

@@ -0,0 +1,103 @@
+package expo.modules.beacon
+
+import android.content.Context
+import android.os.Handler
+import android.os.Looper
+import android.util.Log
+import androidx.car.app.connection.CarConnection
+import androidx.lifecycle.LiveData
+import androidx.lifecycle.Observer
+
+/**
+ * Wraps [CarConnection] LiveData to surface Android Auto / Automotive OS
+ * connection events. No special permissions or Android Auto certification
+ * are required — `CarConnection.type` is read-only state.
+ *
+ * Lifecycle: this monitor uses `observeForever` and therefore must be
+ * explicitly stopped to avoid leaks. The owning module is responsible for
+ * calling [stop] in `OnDestroy`.
+ *
+ * All observer registration / removal happens on the main thread because
+ * [LiveData.observeForever] requires it.
+ */
+internal class CarPlayMonitor(private val context: Context) {
+
+    /** Emit callback signature: (eventName, payload). */
+    fun interface Emit {
+        operator fun invoke(eventName: String, payload: Map<String, Any?>)
+    }
+
+    private val mainHandler = Handler(Looper.getMainLooper())
+    private val liveData: LiveData<Int> = CarConnection(context.applicationContext).type
+    private var observer: Observer<Int>? = null
+    private var emit: Emit? = null
+    @Volatile private var lastConnected: Boolean? = null
+
+    /**
+     * Begin observing connection state. Idempotent — calling twice replaces the
+     * emit callback but does not register a duplicate observer.
+     * Emits `onCarPlayConnected` immediately if already connected.
+     */
+    fun start(emit: Emit) {
+        runOnMain {
+            this.emit = emit
+            if (observer == null) {
+                val obs = Observer<Int> { type -> handleType(type) }
+                observer = obs
+                try {
+                    liveData.observeForever(obs)
+                    Log.d(TAG, "CarPlay monitoring started")
+                } catch (e: Exception) {
+                    Log.w(TAG, "Failed to start CarPlay monitoring: ${e.message}")
+                }
+            }
+        }
+    }
+
+    /** Stop observing connection state and release the emit callback. */
+    fun stop() {
+        runOnMain {
+            observer?.let {
+                try { liveData.removeObserver(it) } catch (_: Exception) {}
+            }
+            observer = null
+            emit = null
+            lastConnected = null
+            Log.d(TAG, "CarPlay monitoring stopped")
+        }
+    }
+
+    private fun handleType(type: Int) {
+        val connected = type != CarConnection.CONNECTION_TYPE_NOT_CONNECTED
+        if (lastConnected == connected) return
+        lastConnected = connected
+        val callback = emit ?: return
+        if (connected) {
+            val transport = when (type) {
+                CarConnection.CONNECTION_TYPE_PROJECTION -> "projection"
+                CarConnection.CONNECTION_TYPE_NATIVE -> "native"
+                else -> "unknown"
+            }
+            callback("onCarPlayConnected", mapOf(
+                "transport" to transport,
+                "timestamp" to System.currentTimeMillis(),
+            ))
+        } else {
+            callback("onCarPlayDisconnected", mapOf(
+                "timestamp" to System.currentTimeMillis(),
+            ))
+        }
+    }
+
+    private fun runOnMain(block: () -> Unit) {
+        if (Looper.myLooper() == Looper.getMainLooper()) {
+            block()
+        } else {
+            mainHandler.post(block)
+        }
+    }
+
+    private companion object {
+        const val TAG = "CarPlayMonitor"
+    }
+}

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

@@ -82,10 +82,13 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
     private var eventLogger: BeaconEventLogger? = null
     @Volatile private var loggingEnabled = false
 
+    // CarPlay / Android Auto monitor (lazy because it requires reactContext)
+    private var carPlayMonitor: CarPlayMonitor? = null
+
     override fun definition() = ModuleDefinition {
         Name("ExpoBeacon")
 
-        Events("onBeaconEnter", "onBeaconExit", "onBeaconDistance", "onBeaconTimeout", "onBeaconFound", "onEddystoneFound", "onEddystoneEnter", "onEddystoneExit", "onEddystoneDistance", "onEddystoneTimeout", "onBeaconError")
+        Events("onBeaconEnter", "onBeaconExit", "onBeaconDistance", "onBeaconTimeout", "onBeaconFound", "onEddystoneFound", "onEddystoneEnter", "onEddystoneExit", "onEddystoneDistance", "onEddystoneTimeout", "onBeaconError", "onCarPlayConnected", "onCarPlayDisconnected")
 
         AsyncFunction("scanForBeaconsAsync") { uuids: List<String>?, scanDurationMs: Int, promise: Promise ->
             if (scanDurationMs <= 0) {
@@ -562,9 +565,35 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
             }
         }
 
+        // MARK: - CarPlay / Android Auto
+
+        AsyncFunction("startCarPlayMonitoring") { promise: Promise ->
+            val ctx = appContext.reactContext
+            if (ctx == null) {
+                promise.reject("NO_CONTEXT", "React context is not available", null)
+                return@AsyncFunction
+            }
+            try {
+                val monitor = carPlayMonitor ?: CarPlayMonitor(ctx).also { carPlayMonitor = it }
+                monitor.start { eventName, payload ->
+                    emitCarPlayEvent(eventName, payload)
+                }
+                promise.resolve(null)
+            } catch (e: Throwable) {
+                promise.reject("CARPLAY_START_FAILED", "Failed to start CarPlay monitoring: ${e.message}", e)
+            }
+        }
+
+        AsyncFunction("stopCarPlayMonitoring") { promise: Promise ->
+            carPlayMonitor?.stop()
+            promise.resolve(null)
+        }
+
         OnDestroy {
             with(this@ExpoBeaconModule) {
                 unregisterEventReceiver()
+                carPlayMonitor?.stop()
+                carPlayMonitor = null
                 loggingEnabled = false
                 eventLogger?.close()
                 eventLogger = null
@@ -1007,4 +1036,24 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
         val identifier = params["identifier"] as? String
         getOrCreateEventLogger()?.logEvent(eventType, identifier, params)
     }
+
+    /**
+     * Emit a CarPlay/Android Auto event to JS, log it to SQLite, forward to the
+     * configured remote API, and dispatch to registered native plugins.
+     */
+    private fun emitCarPlayEvent(eventName: String, payload: Map<String, Any?>) {
+        sendEvent(eventName, payload)
+        logBeaconEvent(eventName, payload)
+        appContext.reactContext?.let { ctx ->
+            try {
+                BeaconApiForwarder(ctx).forwardEvent(payload)
+            } catch (_: Throwable) { /* best-effort */ }
+        }
+        when (eventName) {
+            "onCarPlayConnected" -> BeaconPluginRegistry.dispatchCarPlayConnected(
+                payload["transport"] as? String ?: "unknown"
+            )
+            "onCarPlayDisconnected" -> BeaconPluginRegistry.dispatchCarPlayDisconnected()
+        }
+    }
 }

package/build/ExpoBeacon.types.d.ts

@@ -254,6 +254,19 @@ export type EddystoneTimeoutEvent = {
     /** Current distance in metres at the time the timeout fired. */
     distance: number;
 };
+/** Transport reported with CarPlay / Android Auto connection events. */
+export type CarPlayTransport = "wired" | "wireless" | "projection" | "native" | "unknown";
+/** Payload fired when the device connects to a CarPlay or Android Auto session. */
+export type CarPlayConnectedEvent = {
+    transport: CarPlayTransport;
+    /** Timestamp in milliseconds since epoch. */
+    timestamp: number;
+};
+/** Payload fired when the device disconnects from a CarPlay or Android Auto session. */
+export type CarPlayDisconnectedEvent = {
+    /** Timestamp in milliseconds since epoch. */
+    timestamp: number;
+};
 /** Payload for native beacon error events (monitoring/ranging failures). */
 export type BeaconErrorEvent = {
     /** Region or constraint identifier, empty string if unavailable. */
@@ -281,6 +294,10 @@ export type ExpoBeaconModuleEvents = {
     onEddystoneTimeout: (params: EddystoneTimeoutEvent) => void;
     /** Fired when a native monitoring or ranging failure occurs (logged to DB and forwarded to JS). */
     onBeaconError: (params: BeaconErrorEvent) => void;
+    /** Fired when the device connects to a CarPlay (iOS) or Android Auto (Android) session. */
+    onCarPlayConnected: (params: CarPlayConnectedEvent) => void;
+    /** Fired when the device disconnects from a CarPlay (iOS) or Android Auto (Android) session. */
+    onCarPlayDisconnected: (params: CarPlayDisconnectedEvent) => 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  /** Seconds after last beacon sighting before an exit event fires. Default: 300. */\r\n  exitTimeoutSeconds?: number;\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  /**\r\n   * Seconds after last beacon sighting before an exit event fires when the beacon\r\n   * disappears without moving outside the exit distance threshold.\r\n   *\r\n   * Default: 300 (5 minutes). Minimum: 1.\r\n   */\r\n  exitTimeoutSeconds?: number;\r\n  /** Notification configuration overrides to apply for this monitoring session. */\r\n  notifications?: NotificationConfig;\r\n};\r\n\r\n/** Eddystone frame type. */\r\nexport type EddystoneFrameType = \"uid\" | \"url\";\r\n\r\n/** Raw Eddystone beacon discovered during a scan. */\r\nexport type EddystoneScanResult = {\r\n  frameType: EddystoneFrameType;\r\n  /** 10-byte namespace ID as hex string (20 chars). Present for UID frames. */\r\n  namespace?: string;\r\n  /** 6-byte instance ID as hex string (12 chars). Present for UID frames. */\r\n  instance?: string;\r\n  /** Decoded URL. Present for URL frames. */\r\n  url?: string;\r\n  rssi: number;\r\n  distance: number;\r\n  txPower: number;\r\n  /** BLE advertising device name. */\r\n  name?: string;\r\n};\r\n\r\n/**\r\n * An Eddystone-UID beacon that has been paired/registered for monitoring.\r\n *\r\n * Note: Paired beacon data is stored unencrypted in UserDefaults (iOS) /\r\n * SharedPreferences (Android) and may be included in device backups.\r\n */\r\nexport type PairedEddystone = {\r\n  identifier: string;\r\n  /** 10-byte namespace ID as hex string (20 chars). */\r\n  namespace: string;\r\n  /** 6-byte instance ID as hex string (12 chars). */\r\n  instance: string;\r\n  /** BLE advertising device name, if provided at pairing time. */\r\n  name?: string;\r\n  /**\r\n   * Timeout in seconds. When set, the module fires `onEddystoneTimeout` once\r\n   * after the beacon has been continuously in range for this duration.\r\n   * The timer resets if the beacon exits and re-enters range.\r\n   *\r\n   * 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"]}
+{"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  /** Seconds after last beacon sighting before an exit event fires. Default: 300. */\r\n  exitTimeoutSeconds?: number;\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  /**\r\n   * Seconds after last beacon sighting before an exit event fires when the beacon\r\n   * disappears without moving outside the exit distance threshold.\r\n   *\r\n   * Default: 300 (5 minutes). Minimum: 1.\r\n   */\r\n  exitTimeoutSeconds?: number;\r\n  /** Notification configuration overrides to apply for this monitoring session. */\r\n  notifications?: NotificationConfig;\r\n};\r\n\r\n/** Eddystone frame type. */\r\nexport type EddystoneFrameType = \"uid\" | \"url\";\r\n\r\n/** Raw Eddystone beacon discovered during a scan. */\r\nexport type EddystoneScanResult = {\r\n  frameType: EddystoneFrameType;\r\n  /** 10-byte namespace ID as hex string (20 chars). Present for UID frames. */\r\n  namespace?: string;\r\n  /** 6-byte instance ID as hex string (12 chars). Present for UID frames. */\r\n  instance?: string;\r\n  /** Decoded URL. Present for URL frames. */\r\n  url?: string;\r\n  rssi: number;\r\n  distance: number;\r\n  txPower: number;\r\n  /** BLE advertising device name. */\r\n  name?: string;\r\n};\r\n\r\n/**\r\n * An Eddystone-UID beacon that has been paired/registered for monitoring.\r\n *\r\n * Note: Paired beacon data is stored unencrypted in UserDefaults (iOS) /\r\n * SharedPreferences (Android) and may be included in device backups.\r\n */\r\nexport type PairedEddystone = {\r\n  identifier: string;\r\n  /** 10-byte namespace ID as hex string (20 chars). */\r\n  namespace: string;\r\n  /** 6-byte instance ID as hex string (12 chars). */\r\n  instance: string;\r\n  /** BLE advertising device name, if provided at pairing time. */\r\n  name?: string;\r\n  /**\r\n   * Timeout in seconds. When set, the module fires `onEddystoneTimeout` once\r\n   * after the beacon has been continuously in range for this duration.\r\n   * The timer resets if the beacon exits and re-enters range.\r\n   *\r\n   * 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/** Transport reported with CarPlay / Android Auto connection events. */\r\nexport type CarPlayTransport =\r\n  | \"wired\"      // iOS CarPlay over USB / Lightning\r\n  | \"wireless\"   // iOS CarPlay over Bluetooth + Wi-Fi\r\n  | \"projection\" // Android Auto projection (phone projecting to head unit)\r\n  | \"native\"     // Android Automotive OS (running on the head unit)\r\n  | \"unknown\";\r\n\r\n/** Payload fired when the device connects to a CarPlay or Android Auto session. */\r\nexport type CarPlayConnectedEvent = {\r\n  transport: CarPlayTransport;\r\n  /** Timestamp in milliseconds since epoch. */\r\n  timestamp: number;\r\n};\r\n\r\n/** Payload fired when the device disconnects from a CarPlay or Android Auto session. */\r\nexport type CarPlayDisconnectedEvent = {\r\n  /** Timestamp in milliseconds since epoch. */\r\n  timestamp: 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  /** Fired when the device connects to a CarPlay (iOS) or Android Auto (Android) session. */\r\n  onCarPlayConnected: (params: CarPlayConnectedEvent) => void;\r\n  /** Fired when the device disconnects from a CarPlay (iOS) or Android Auto (Android) session. */\r\n  onCarPlayDisconnected: (params: CarPlayDisconnectedEvent) => void;\r\n};\r\n\r\n/** Options for filtering event logs. */\r\nexport type EventLogQueryOptions = {\r\n  /** Maximum number of log entries to return (default: 1000, max: 10000). */\r\n  limit?: number;\r\n  /** Filter by event type (e.g. \"onBeaconEnter\", \"onBeaconExit\"). */\r\n  eventType?: string;\r\n  /** Only return events with timestamp >= this value (ms since epoch). */\r\n  sinceTimestamp?: number;\r\n};\r\n\r\n/** A single logged beacon event entry. */\r\nexport type EventLogEntry = {\r\n  id: number;\r\n  /** Timestamp in milliseconds since epoch. */\r\n  timestamp: number;\r\n  /** The event type that was logged (e.g. \"onBeaconEnter\"). */\r\n  eventType: string;\r\n  /** Beacon identifier, if available. */\r\n  identifier?: string;\r\n  /** The full event payload that was sent to JS. */\r\n  data: Record<string, unknown>;\r\n};\r\n"]}

package/build/ExpoBeaconModule.d.ts

@@ -135,6 +135,25 @@ declare class ExpoBeaconModule extends NativeModule<ExpoBeaconModuleEvents> {
         apiKey: string | null;
         id: string | null;
     };
+    /**
+     * Start observing CarPlay (iOS) / Android Auto (Android) connection state.
+     *
+     * Emits `onCarPlayConnected` and `onCarPlayDisconnected` JS events. Events are
+     * also written to the SQLite event log and forwarded to the configured API
+     * endpoint, and dispatched to native lifecycle plugins (used by the auto-
+     * generated geolocation plugin to start/stop background-geolocation).
+     *
+     * Safe to call multiple times — subsequent calls are no-ops.
+     *
+     * - iOS: observes `AVAudioSession.routeChangeNotification` for `.carAudio` ports.
+     *   No CarPlay entitlement required.
+     * - Android: observes `androidx.car.app.connection.CarConnection` LiveData.
+     *   No Android Auto certification required.
+     * - Web: no-op (resolves immediately).
+     */
+    startCarPlayMonitoring(): Promise<void>;
+    /** Stop CarPlay / Android Auto connection monitoring started by `startCarPlayMonitoring()`. */
+    stopCarPlayMonitoring(): Promise<void>;
 }
 declare const _default: ExpoBeaconModule;
 export default _default;

package/build/ExpoBeaconModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoBeaconModule.d.ts","sourceRoot":"","sources":["../src/ExpoBeaconModule.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ExpoBeaconModule.d.ts","sourceRoot":"","sources":["../src/ExpoBeaconModule.ts"],"names":[],"mappings":"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"}

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;AAiMzD,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  MonitoringConfig,\r\n  MonitoredDeviceState,\r\n  EventLogQueryOptions,\r\n  EventLogEntry,\r\n} from \"./ExpoBeacon.types\";\r\n\r\ndeclare class ExpoBeaconModule extends NativeModule<ExpoBeaconModuleEvents> {\r\n  /**\r\n   * Start a one-shot iBeacon scan. Resolves with discovered beacons after scanDuration ms.\r\n   *\r\n   * Pass one or more UUIDs to scan for specific beacons (uses CoreLocation on iOS).\r\n   * On iOS, at least one UUID is required — Apple strips iBeacon data from BLE\r\n   * advertisements, making wildcard discovery impossible. When you pass an empty\r\n   * array, the module automatically uses UUIDs from paired beacons.\r\n   * On Android, pass an empty array to discover all nearby iBeacons.\r\n   *\r\n   * @param uuids Proximity UUIDs to filter by. Empty/omitted = use paired UUIDs (iOS) or wildcard (Android).\r\n   * @param scanDuration Duration in ms (default 5000)\r\n   */\r\n  scanForBeaconsAsync(\r\n    uuids?: string[],\r\n    scanDuration?: number,\r\n  ): Promise<BeaconScanResult[]>;\r\n\r\n  /**\r\n   * Start a one-shot Eddystone beacon scan using BLE.\r\n   * Discovers Eddystone-UID and Eddystone-URL frames.\r\n   *\r\n   * @param scanDuration Duration in ms (default 5000)\r\n   */\r\n  scanForEddystonesAsync(\r\n    scanDuration?: number,\r\n  ): Promise<EddystoneScanResult[]>;\r\n\r\n  /**\r\n   * Register a beacon for persistent region monitoring.\r\n   */\r\n  pairBeacon(\r\n    identifier: string,\r\n    uuid: string,\r\n    major: number,\r\n    minor: number,\r\n    name?: string,\r\n    timeoutSeconds?: number,\r\n  ): void;\r\n\r\n  /**\r\n   * Remove a previously paired beacon.\r\n   */\r\n  unpairBeacon(identifier: string): void;\r\n\r\n  /**\r\n   * Return all currently paired beacons.\r\n   */\r\n  getPairedBeacons(): PairedBeacon[];\r\n\r\n  /**\r\n   * Register an Eddystone-UID beacon for persistent monitoring.\r\n   */\r\n  pairEddystone(\r\n    identifier: string,\r\n    namespace: string,\r\n    instance: string,\r\n    name?: string,\r\n    timeoutSeconds?: number,\r\n  ): void;\r\n\r\n  /**\r\n   * Remove a previously paired Eddystone beacon.\r\n   */\r\n  unpairEddystone(identifier: string): void;\r\n\r\n  /**\r\n   * Return all currently paired Eddystone beacons.\r\n   */\r\n  getPairedEddystones(): PairedEddystone[];\r\n\r\n  /**\r\n   * Set persistent notification configuration. Settings are saved and applied to all\r\n   * subsequent monitoring sessions until explicitly changed.\r\n   */\r\n  setNotificationConfig(config: NotificationConfig): void;\r\n\r\n  /**\r\n   * Start background region monitoring for all paired beacons.\r\n   * On Android starts a foreground service.\r\n   * On iOS starts CLLocationManager region monitoring.\r\n   *\r\n   * Accepts a plain number (backward-compatible maxDistance shorthand) or a\r\n   * MonitoringOptions object with maxDistance and/or notification overrides.\r\n   */\r\n  startMonitoring(options?: MonitoringOptions | number): Promise<void>;\r\n\r\n  /**\r\n   * Stop background region monitoring.\r\n   */\r\n  stopMonitoring(): Promise<void>;\r\n\r\n  /**\r\n   * Start a continuous BLE scan. Fires `onBeaconFound` events as beacons are detected.\r\n   * Call stopContinuousScan() to end the scan.\r\n   */\r\n  startContinuousScan(): void;\r\n\r\n  /** Stop the continuous scan started by startContinuousScan(). */\r\n  stopContinuousScan(): void;\r\n\r\n  /**\r\n   * Cancel any in-progress one-shot scan (iBeacon or Eddystone).\r\n   * The pending promise will be rejected with code \"SCAN_CANCELLED\".\r\n   */\r\n  cancelScan(): void;\r\n\r\n  /** Request Bluetooth + Location permissions. Returns true if granted. */\r\n  requestPermissionsAsync(): Promise<boolean>;\r\n\r\n  /**\r\n   * Check whether the app is exempt from Android battery optimizations.\r\n   * Always returns true on iOS and web (no equivalent concept).\r\n   */\r\n  isBatteryOptimizationExempt(): boolean;\r\n\r\n  /**\r\n   * Request exemption from Android battery optimizations.\r\n   * Opens the system dialog asking the user to whitelist this app.\r\n   * Returns true if the dialog was shown (or already exempt), false on failure.\r\n   * Always resolves true on iOS and web.\r\n   */\r\n  requestBatteryOptimizationExemption(): Promise<boolean>;\r\n\r\n  /** Enable SQLite event logging. All beacon events will be persisted to a local database. */\r\n  enableEventLogging(): void;\r\n\r\n  /** Disable event logging. Previously logged events are retained. */\r\n  disableEventLogging(): void;\r\n\r\n  /**\r\n   * Retrieve logged beacon events from the SQLite database.\r\n   * @param options Optional filters (limit, eventType, sinceTimestamp).\r\n   */\r\n  getEventLogs(options?: EventLogQueryOptions): EventLogEntry[];\r\n\r\n  /** Delete all logged events from the database. */\r\n  clearEventLogs(): void;\r\n\r\n  /** Delete the entire event log database. Also disables logging. */\r\n  destroyEventLogs(): void;\r\n\r\n  /**\r\n   * Configure a remote API endpoint for native event forwarding.\r\n   * Once set, beacon events are POSTed directly from native code,\r\n   * ensuring delivery even when the JS bridge is not active (app backgrounded).\r\n   *\r\n   * @param url The API endpoint URL to POST events to.\r\n   * @param apiKey Optional API key sent as X-CSFR-Token header.\r\n   * @param id Optional identifier appended to every forwarded event payload.\r\n   */\r\n  setApiEndpoint(url: string, apiKey?: string, id?: string): void;\r\n\r\n  /**\r\n   * Return the current monitoring configuration and active state.\r\n   * Option fields are undefined if not explicitly set.\r\n   */\r\n  getMonitoringConfig(): MonitoringConfig;\r\n\r\n  /**\r\n   * Return the current state snapshot for a paired monitored device.\r\n   * Returns null when no paired device matches the identifier.\r\n   */\r\n  getMonitoredDeviceState(identifier: string): MonitoredDeviceState | null;\r\n\r\n  /**\r\n   * Return the current state snapshot for all paired monitored devices.\r\n   */\r\n  getMonitoredDeviceStates(): MonitoredDeviceState[];\r\n\r\n  /**\r\n   * Return the current API forwarding configuration.\r\n   * Each field is `null` if not set.\r\n   */\r\n  getApiEndpoint(): { url: string | null; apiKey: string | null; id: string | null };\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;AAsNzD,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  MonitoringConfig,\r\n  MonitoredDeviceState,\r\n  EventLogQueryOptions,\r\n  EventLogEntry,\r\n} from \"./ExpoBeacon.types\";\r\n\r\ndeclare class ExpoBeaconModule extends NativeModule<ExpoBeaconModuleEvents> {\r\n  /**\r\n   * Start a one-shot iBeacon scan. Resolves with discovered beacons after scanDuration ms.\r\n   *\r\n   * Pass one or more UUIDs to scan for specific beacons (uses CoreLocation on iOS).\r\n   * On iOS, at least one UUID is required — Apple strips iBeacon data from BLE\r\n   * advertisements, making wildcard discovery impossible. When you pass an empty\r\n   * array, the module automatically uses UUIDs from paired beacons.\r\n   * On Android, pass an empty array to discover all nearby iBeacons.\r\n   *\r\n   * @param uuids Proximity UUIDs to filter by. Empty/omitted = use paired UUIDs (iOS) or wildcard (Android).\r\n   * @param scanDuration Duration in ms (default 5000)\r\n   */\r\n  scanForBeaconsAsync(\r\n    uuids?: string[],\r\n    scanDuration?: number,\r\n  ): Promise<BeaconScanResult[]>;\r\n\r\n  /**\r\n   * Start a one-shot Eddystone beacon scan using BLE.\r\n   * Discovers Eddystone-UID and Eddystone-URL frames.\r\n   *\r\n   * @param scanDuration Duration in ms (default 5000)\r\n   */\r\n  scanForEddystonesAsync(\r\n    scanDuration?: number,\r\n  ): Promise<EddystoneScanResult[]>;\r\n\r\n  /**\r\n   * Register a beacon for persistent region monitoring.\r\n   */\r\n  pairBeacon(\r\n    identifier: string,\r\n    uuid: string,\r\n    major: number,\r\n    minor: number,\r\n    name?: string,\r\n    timeoutSeconds?: number,\r\n  ): void;\r\n\r\n  /**\r\n   * Remove a previously paired beacon.\r\n   */\r\n  unpairBeacon(identifier: string): void;\r\n\r\n  /**\r\n   * Return all currently paired beacons.\r\n   */\r\n  getPairedBeacons(): PairedBeacon[];\r\n\r\n  /**\r\n   * Register an Eddystone-UID beacon for persistent monitoring.\r\n   */\r\n  pairEddystone(\r\n    identifier: string,\r\n    namespace: string,\r\n    instance: string,\r\n    name?: string,\r\n    timeoutSeconds?: number,\r\n  ): void;\r\n\r\n  /**\r\n   * Remove a previously paired Eddystone beacon.\r\n   */\r\n  unpairEddystone(identifier: string): void;\r\n\r\n  /**\r\n   * Return all currently paired Eddystone beacons.\r\n   */\r\n  getPairedEddystones(): PairedEddystone[];\r\n\r\n  /**\r\n   * Set persistent notification configuration. Settings are saved and applied to all\r\n   * subsequent monitoring sessions until explicitly changed.\r\n   */\r\n  setNotificationConfig(config: NotificationConfig): void;\r\n\r\n  /**\r\n   * Start background region monitoring for all paired beacons.\r\n   * On Android starts a foreground service.\r\n   * On iOS starts CLLocationManager region monitoring.\r\n   *\r\n   * Accepts a plain number (backward-compatible maxDistance shorthand) or a\r\n   * MonitoringOptions object with maxDistance and/or notification overrides.\r\n   */\r\n  startMonitoring(options?: MonitoringOptions | number): Promise<void>;\r\n\r\n  /**\r\n   * Stop background region monitoring.\r\n   */\r\n  stopMonitoring(): Promise<void>;\r\n\r\n  /**\r\n   * Start a continuous BLE scan. Fires `onBeaconFound` events as beacons are detected.\r\n   * Call stopContinuousScan() to end the scan.\r\n   */\r\n  startContinuousScan(): void;\r\n\r\n  /** Stop the continuous scan started by startContinuousScan(). */\r\n  stopContinuousScan(): void;\r\n\r\n  /**\r\n   * Cancel any in-progress one-shot scan (iBeacon or Eddystone).\r\n   * The pending promise will be rejected with code \"SCAN_CANCELLED\".\r\n   */\r\n  cancelScan(): void;\r\n\r\n  /** Request Bluetooth + Location permissions. Returns true if granted. */\r\n  requestPermissionsAsync(): Promise<boolean>;\r\n\r\n  /**\r\n   * Check whether the app is exempt from Android battery optimizations.\r\n   * Always returns true on iOS and web (no equivalent concept).\r\n   */\r\n  isBatteryOptimizationExempt(): boolean;\r\n\r\n  /**\r\n   * Request exemption from Android battery optimizations.\r\n   * Opens the system dialog asking the user to whitelist this app.\r\n   * Returns true if the dialog was shown (or already exempt), false on failure.\r\n   * Always resolves true on iOS and web.\r\n   */\r\n  requestBatteryOptimizationExemption(): Promise<boolean>;\r\n\r\n  /** Enable SQLite event logging. All beacon events will be persisted to a local database. */\r\n  enableEventLogging(): void;\r\n\r\n  /** Disable event logging. Previously logged events are retained. */\r\n  disableEventLogging(): void;\r\n\r\n  /**\r\n   * Retrieve logged beacon events from the SQLite database.\r\n   * @param options Optional filters (limit, eventType, sinceTimestamp).\r\n   */\r\n  getEventLogs(options?: EventLogQueryOptions): EventLogEntry[];\r\n\r\n  /** Delete all logged events from the database. */\r\n  clearEventLogs(): void;\r\n\r\n  /** Delete the entire event log database. Also disables logging. */\r\n  destroyEventLogs(): void;\r\n\r\n  /**\r\n   * Configure a remote API endpoint for native event forwarding.\r\n   * Once set, beacon events are POSTed directly from native code,\r\n   * ensuring delivery even when the JS bridge is not active (app backgrounded).\r\n   *\r\n   * @param url The API endpoint URL to POST events to.\r\n   * @param apiKey Optional API key sent as X-CSFR-Token header.\r\n   * @param id Optional identifier appended to every forwarded event payload.\r\n   */\r\n  setApiEndpoint(url: string, apiKey?: string, id?: string): void;\r\n\r\n  /**\r\n   * Return the current monitoring configuration and active state.\r\n   * Option fields are undefined if not explicitly set.\r\n   */\r\n  getMonitoringConfig(): MonitoringConfig;\r\n\r\n  /**\r\n   * Return the current state snapshot for a paired monitored device.\r\n   * Returns null when no paired device matches the identifier.\r\n   */\r\n  getMonitoredDeviceState(identifier: string): MonitoredDeviceState | null;\r\n\r\n  /**\r\n   * Return the current state snapshot for all paired monitored devices.\r\n   */\r\n  getMonitoredDeviceStates(): MonitoredDeviceState[];\r\n\r\n  /**\r\n   * Return the current API forwarding configuration.\r\n   * Each field is `null` if not set.\r\n   */\r\n  getApiEndpoint(): { url: string | null; apiKey: string | null; id: string | null };\r\n\r\n  /**\r\n   * Start observing CarPlay (iOS) / Android Auto (Android) connection state.\r\n   *\r\n   * Emits `onCarPlayConnected` and `onCarPlayDisconnected` JS events. Events are\r\n   * also written to the SQLite event log and forwarded to the configured API\r\n   * endpoint, and dispatched to native lifecycle plugins (used by the auto-\r\n   * generated geolocation plugin to start/stop background-geolocation).\r\n   *\r\n   * Safe to call multiple times — subsequent calls are no-ops.\r\n   *\r\n   * - iOS: observes `AVAudioSession.routeChangeNotification` for `.carAudio` ports.\r\n   *   No CarPlay entitlement required.\r\n   * - Android: observes `androidx.car.app.connection.CarConnection` LiveData.\r\n   *   No Android Auto certification required.\r\n   * - Web: no-op (resolves immediately).\r\n   */\r\n  startCarPlayMonitoring(): Promise<void>;\r\n\r\n  /** Stop CarPlay / Android Auto connection monitoring started by `startCarPlayMonitoring()`. */\r\n  stopCarPlayMonitoring(): Promise<void>;\r\n}\r\n\r\nexport default requireNativeModule<ExpoBeaconModule>(\"ExpoBeacon\");\r\n"]}

package/build/ExpoBeaconModule.web.d.ts

@@ -30,6 +30,8 @@ declare const stub: {
     };
     isBatteryOptimizationExempt: () => boolean;
     requestBatteryOptimizationExemption: () => Promise<boolean>;
+    startCarPlayMonitoring: () => Promise<void>;
+    stopCarPlayMonitoring: () => Promise<void>;
     addListener: (_eventName: keyof ExpoBeaconModuleEvents, _listener: any) => {
         remove: () => void;
     };

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,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACd,MAAM,oBAAoB,CAAC;AAM5B,QAAA,MAAM,IAAI;kCAEE,MAAM,EAAE,kBACA,MAAM,KACrB,OAAO,CAAC,gBAAgB,EAAE,CAAC;6CAEZ,MAAM,KACrB,OAAO,CAAC,mBAAmB,EAAE,CAAC;8BAElB,MAAM,SACZ,MAAM,UACL,MAAM,UACN,MAAM,KACb,IAAI;gCACqB,MAAM,KAAG,IAAI;4BACnB,YAAY,EAAE;iCAErB,MAAM,cACP,MAAM,aACP,MAAM,KAChB,IAAI;mCACwB,MAAM,KAAG,IAAI;+BACnB,eAAe,EAAE;2BACrB,OAAO,CAAC,IAAI,CAAC;0BACd,OAAO,CAAC,IAAI,CAAC;+BACR,IAAI;8BACL,IAAI;sBACZ,IAAI;qCACa,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;mCAClC,OAAO,CAAC,OAAO,CAAC;8BACrB,IAAI;+BACH,IAAI;8BACH,oBAAoB,KAAG,aAAa,EAAE;0BAC5C,IAAI;4BACF,IAAI;;2CAEa,MAAM,KAAG,oBAAoB,GAAG,IAAI;oCAC7C,oBAAoB,EAAE;0BAChC;QAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;uCACnD,OAAO;+CACC,OAAO,CAAC,OAAO,CAAC;8BAC/B,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,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACd,MAAM,oBAAoB,CAAC;AAM5B,QAAA,MAAM,IAAI;kCAEE,MAAM,EAAE,kBACA,MAAM,KACrB,OAAO,CAAC,gBAAgB,EAAE,CAAC;6CAEZ,MAAM,KACrB,OAAO,CAAC,mBAAmB,EAAE,CAAC;8BAElB,MAAM,SACZ,MAAM,UACL,MAAM,UACN,MAAM,KACb,IAAI;gCACqB,MAAM,KAAG,IAAI;4BACnB,YAAY,EAAE;iCAErB,MAAM,cACP,MAAM,aACP,MAAM,KAChB,IAAI;mCACwB,MAAM,KAAG,IAAI;+BACnB,eAAe,EAAE;2BACrB,OAAO,CAAC,IAAI,CAAC;0BACd,OAAO,CAAC,IAAI,CAAC;+BACR,IAAI;8BACL,IAAI;sBACZ,IAAI;qCACa,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;mCAClC,OAAO,CAAC,OAAO,CAAC;8BACrB,IAAI;+BACH,IAAI;8BACH,oBAAoB,KAAG,aAAa,EAAE;0BAC5C,IAAI;4BACF,IAAI;;2CAEa,MAAM,KAAG,oBAAoB,GAAG,IAAI;oCAC7C,oBAAoB,EAAE;0BAChC;QAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;uCACnD,OAAO;+CACC,OAAO,CAAC,OAAO,CAAC;kCAC7B,OAAO,CAAC,IAAI,CAAC;iCACd,OAAO,CAAC,IAAI,CAAC;8BACd,MAAM,sBAAsB,aAAa,GAAG;;;qCAGrC,MAAM,sBAAsB;CAC9D,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/build/ExpoBeaconModule.web.js

@@ -28,6 +28,8 @@ const stub = {
     getApiEndpoint: () => notSupported(),
     isBatteryOptimizationExempt: () => true,
     requestBatteryOptimizationExemption: () => Promise.resolve(true),
+    startCarPlayMonitoring: () => Promise.resolve(),
+    stopCarPlayMonitoring: () => Promise.resolve(),
     addListener: (_eventName, _listener) => ({
         remove: () => { },
     }),

package/build/ExpoBeaconModule.web.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoBeaconModule.web.js","sourceRoot":"","sources":["../src/ExpoBeaconModule.web.ts"],"names":[],"mappings":"AAWA,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,sBAAsB,EAAE,CACtB,aAAsB,EACU,EAAE,CAAC,YAAY,EAAE;IACnD,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,aAAa,EAAE,CACb,WAAmB,EACnB,UAAkB,EAClB,SAAiB,EACX,EAAE,CAAC,YAAY,EAAE;IACzB,eAAe,EAAE,CAAC,WAAmB,EAAQ,EAAE,CAAC,YAAY,EAAE;IAC9D,mBAAmB,EAAE,GAAsB,EAAE,CAAC,YAAY,EAAE;IAC5D,eAAe,EAAE,GAAkB,EAAE,CAAC,YAAY,EAAE;IACpD,cAAc,EAAE,GAAkB,EAAE,CAAC,YAAY,EAAE;IACnD,mBAAmB,EAAE,GAAS,EAAE,CAAC,YAAY,EAAE;IAC/C,kBAAkB,EAAE,GAAS,EAAE,CAAC,YAAY,EAAE;IAC9C,UAAU,EAAE,GAAS,EAAE,CAAC,YAAY,EAAE;IACtC,qBAAqB,EAAE,CAAC,OAAgC,EAAQ,EAAE,CAAC,YAAY,EAAE;IACjF,uBAAuB,EAAE,GAAqB,EAAE,CAAC,YAAY,EAAE;IAC/D,kBAAkB,EAAE,GAAS,EAAE,CAAC,YAAY,EAAE;IAC9C,mBAAmB,EAAE,GAAS,EAAE,CAAC,YAAY,EAAE;IAC/C,YAAY,EAAE,CAAC,QAA+B,EAAmB,EAAE,CAAC,YAAY,EAAE;IAClF,cAAc,EAAE,GAAS,EAAE,CAAC,YAAY,EAAE;IAC1C,gBAAgB,EAAE,GAAS,EAAE,CAAC,YAAY,EAAE;IAC5C,mBAAmB,EAAE,GAAG,EAAE,CAAC,YAAY,EAAE;IACzC,uBAAuB,EAAE,CAAC,WAAmB,EAA+B,EAAE,CAAC,YAAY,EAAE;IAC7F,wBAAwB,EAAE,GAA2B,EAAE,CAAC,YAAY,EAAE;IACtE,cAAc,EAAE,GAAqE,EAAE,CAAC,YAAY,EAAE;IACtG,2BAA2B,EAAE,GAAY,EAAE,CAAC,IAAI;IAChD,mCAAmC,EAAE,GAAqB,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;IAClF,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  EddystoneScanResult,\r\n  PairedBeacon,\r\n  PairedEddystone,\r\n  MonitoredDeviceState,\r\n  EventLogQueryOptions,\r\n  EventLogEntry,\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  scanForEddystonesAsync: (\r\n    _scanDuration?: number,\r\n  ): Promise<EddystoneScanResult[]> => 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  pairEddystone: (\r\n    _identifier: string,\r\n    _namespace: string,\r\n    _instance: string,\r\n  ): void => notSupported(),\r\n  unpairEddystone: (_identifier: string): void => notSupported(),\r\n  getPairedEddystones: (): PairedEddystone[] => notSupported(),\r\n  startMonitoring: (): Promise<void> => notSupported(),\r\n  stopMonitoring: (): Promise<void> => notSupported(),\r\n  startContinuousScan: (): void => notSupported(),\r\n  stopContinuousScan: (): void => notSupported(),\r\n  cancelScan: (): void => notSupported(),\r\n  setNotificationConfig: (_config: Record<string, unknown>): void => notSupported(),\r\n  requestPermissionsAsync: (): Promise<boolean> => notSupported(),\r\n  enableEventLogging: (): void => notSupported(),\r\n  disableEventLogging: (): void => notSupported(),\r\n  getEventLogs: (_options?: EventLogQueryOptions): EventLogEntry[] => notSupported(),\r\n  clearEventLogs: (): void => notSupported(),\r\n  destroyEventLogs: (): void => notSupported(),\r\n  getMonitoringConfig: () => notSupported(),\r\n  getMonitoredDeviceState: (_identifier: string): MonitoredDeviceState | null => notSupported(),\r\n  getMonitoredDeviceStates: (): MonitoredDeviceState[] => notSupported(),\r\n  getApiEndpoint: (): { url: string | null; apiKey: string | null; id: string | null } => notSupported(),\r\n  isBatteryOptimizationExempt: (): boolean => true,\r\n  requestBatteryOptimizationExemption: (): Promise<boolean> => Promise.resolve(true),\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":"AAWA,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,sBAAsB,EAAE,CACtB,aAAsB,EACU,EAAE,CAAC,YAAY,EAAE;IACnD,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,aAAa,EAAE,CACb,WAAmB,EACnB,UAAkB,EAClB,SAAiB,EACX,EAAE,CAAC,YAAY,EAAE;IACzB,eAAe,EAAE,CAAC,WAAmB,EAAQ,EAAE,CAAC,YAAY,EAAE;IAC9D,mBAAmB,EAAE,GAAsB,EAAE,CAAC,YAAY,EAAE;IAC5D,eAAe,EAAE,GAAkB,EAAE,CAAC,YAAY,EAAE;IACpD,cAAc,EAAE,GAAkB,EAAE,CAAC,YAAY,EAAE;IACnD,mBAAmB,EAAE,GAAS,EAAE,CAAC,YAAY,EAAE;IAC/C,kBAAkB,EAAE,GAAS,EAAE,CAAC,YAAY,EAAE;IAC9C,UAAU,EAAE,GAAS,EAAE,CAAC,YAAY,EAAE;IACtC,qBAAqB,EAAE,CAAC,OAAgC,EAAQ,EAAE,CAAC,YAAY,EAAE;IACjF,uBAAuB,EAAE,GAAqB,EAAE,CAAC,YAAY,EAAE;IAC/D,kBAAkB,EAAE,GAAS,EAAE,CAAC,YAAY,EAAE;IAC9C,mBAAmB,EAAE,GAAS,EAAE,CAAC,YAAY,EAAE;IAC/C,YAAY,EAAE,CAAC,QAA+B,EAAmB,EAAE,CAAC,YAAY,EAAE;IAClF,cAAc,EAAE,GAAS,EAAE,CAAC,YAAY,EAAE;IAC1C,gBAAgB,EAAE,GAAS,EAAE,CAAC,YAAY,EAAE;IAC5C,mBAAmB,EAAE,GAAG,EAAE,CAAC,YAAY,EAAE;IACzC,uBAAuB,EAAE,CAAC,WAAmB,EAA+B,EAAE,CAAC,YAAY,EAAE;IAC7F,wBAAwB,EAAE,GAA2B,EAAE,CAAC,YAAY,EAAE;IACtE,cAAc,EAAE,GAAqE,EAAE,CAAC,YAAY,EAAE;IACtG,2BAA2B,EAAE,GAAY,EAAE,CAAC,IAAI;IAChD,mCAAmC,EAAE,GAAqB,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;IAClF,sBAAsB,EAAE,GAAkB,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;IAC9D,qBAAqB,EAAE,GAAkB,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;IAC7D,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  EddystoneScanResult,\r\n  PairedBeacon,\r\n  PairedEddystone,\r\n  MonitoredDeviceState,\r\n  EventLogQueryOptions,\r\n  EventLogEntry,\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  scanForEddystonesAsync: (\r\n    _scanDuration?: number,\r\n  ): Promise<EddystoneScanResult[]> => 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  pairEddystone: (\r\n    _identifier: string,\r\n    _namespace: string,\r\n    _instance: string,\r\n  ): void => notSupported(),\r\n  unpairEddystone: (_identifier: string): void => notSupported(),\r\n  getPairedEddystones: (): PairedEddystone[] => notSupported(),\r\n  startMonitoring: (): Promise<void> => notSupported(),\r\n  stopMonitoring: (): Promise<void> => notSupported(),\r\n  startContinuousScan: (): void => notSupported(),\r\n  stopContinuousScan: (): void => notSupported(),\r\n  cancelScan: (): void => notSupported(),\r\n  setNotificationConfig: (_config: Record<string, unknown>): void => notSupported(),\r\n  requestPermissionsAsync: (): Promise<boolean> => notSupported(),\r\n  enableEventLogging: (): void => notSupported(),\r\n  disableEventLogging: (): void => notSupported(),\r\n  getEventLogs: (_options?: EventLogQueryOptions): EventLogEntry[] => notSupported(),\r\n  clearEventLogs: (): void => notSupported(),\r\n  destroyEventLogs: (): void => notSupported(),\r\n  getMonitoringConfig: () => notSupported(),\r\n  getMonitoredDeviceState: (_identifier: string): MonitoredDeviceState | null => notSupported(),\r\n  getMonitoredDeviceStates: (): MonitoredDeviceState[] => notSupported(),\r\n  getApiEndpoint: (): { url: string | null; apiKey: string | null; id: string | null } => notSupported(),\r\n  isBatteryOptimizationExempt: (): boolean => true,\r\n  requestBatteryOptimizationExemption: (): Promise<boolean> => Promise.resolve(true),\r\n  startCarPlayMonitoring: (): Promise<void> => Promise.resolve(),\r\n  stopCarPlayMonitoring: (): Promise<void> => Promise.resolve(),\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.js";
-export type { BeaconScanResult, PairedBeacon, BeaconRegionEvent, BeaconDistanceEvent, BeaconTimeoutEvent, ExpoBeaconModuleEvents, NotificationConfig, MonitoringOptions, MonitoringConfig, MonitoredDeviceState, BeaconNotificationConfig, ForegroundServiceConfig, NotificationChannelConfig, EddystoneFrameType, EddystoneScanResult, PairedEddystone, EddystoneRegionEvent, EddystoneDistanceEvent, EddystoneTimeoutEvent, EventLogQueryOptions, EventLogEntry, } from "./ExpoBeacon.types";
+export type { BeaconScanResult, PairedBeacon, BeaconRegionEvent, BeaconDistanceEvent, BeaconTimeoutEvent, ExpoBeaconModuleEvents, NotificationConfig, MonitoringOptions, MonitoringConfig, MonitoredDeviceState, BeaconNotificationConfig, ForegroundServiceConfig, NotificationChannelConfig, EddystoneFrameType, EddystoneScanResult, PairedEddystone, EddystoneRegionEvent, EddystoneDistanceEvent, EddystoneTimeoutEvent, EventLogQueryOptions, EventLogEntry, CarPlayTransport, CarPlayConnectedEvent, CarPlayDisconnectedEvent, } 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,uBAAuB,CAAC;AAGhD,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,GACd,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGhD,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,GACzB,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,uBAAuB,CAAC","sourcesContent":["// Native module (default export)\r\nexport { default } from \"./ExpoBeaconModule.js\";\r\n\r\n// All public types\r\nexport type {\r\n  BeaconScanResult,\r\n  PairedBeacon,\r\n  BeaconRegionEvent,\r\n  BeaconDistanceEvent,\r\n  BeaconTimeoutEvent,\r\n  ExpoBeaconModuleEvents,\r\n  NotificationConfig,\r\n  MonitoringOptions,\r\n  MonitoringConfig,\r\n  MonitoredDeviceState,\r\n  BeaconNotificationConfig,\r\n  ForegroundServiceConfig,\r\n  NotificationChannelConfig,\r\n  EddystoneFrameType,\r\n  EddystoneScanResult,\r\n  PairedEddystone,\r\n  EddystoneRegionEvent,\r\n  EddystoneDistanceEvent,\r\n  EddystoneTimeoutEvent,\r\n  EventLogQueryOptions,\r\n  EventLogEntry,\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,uBAAuB,CAAC","sourcesContent":["// Native module (default export)\r\nexport { default } from \"./ExpoBeaconModule.js\";\r\n\r\n// All public types\r\nexport type {\r\n  BeaconScanResult,\r\n  PairedBeacon,\r\n  BeaconRegionEvent,\r\n  BeaconDistanceEvent,\r\n  BeaconTimeoutEvent,\r\n  ExpoBeaconModuleEvents,\r\n  NotificationConfig,\r\n  MonitoringOptions,\r\n  MonitoringConfig,\r\n  MonitoredDeviceState,\r\n  BeaconNotificationConfig,\r\n  ForegroundServiceConfig,\r\n  NotificationChannelConfig,\r\n  EddystoneFrameType,\r\n  EddystoneScanResult,\r\n  PairedEddystone,\r\n  EddystoneRegionEvent,\r\n  EddystoneDistanceEvent,\r\n  EddystoneTimeoutEvent,\r\n  EventLogQueryOptions,\r\n  EventLogEntry,\r\n  CarPlayTransport,\r\n  CarPlayConnectedEvent,\r\n  CarPlayDisconnectedEvent,\r\n} from \"./ExpoBeacon.types\";\r\n"]}

package/ios/BeaconLifecycleDelegate.swift

@@ -15,6 +15,20 @@ public protocol BeaconLifecycleDelegate: AnyObject {
     func eddystoneDidEnter(identifier: String, namespace: String, instance: String, distance: Double)
     func eddystoneDidExit(identifier: String, namespace: String, instance: String, distance: Double)
     func eddystoneDidTimeout(identifier: String, namespace: String, instance: String, distance: Double)
+
+    // MARK: CarPlay
+    /// Called when the device connects to a CarPlay session (wired or wireless).
+    /// Default implementation is empty so existing plugins compile unchanged.
+    func carPlayDidConnect(transport: String)
+    /// Called when the device disconnects from a CarPlay session.
+    /// Default implementation is empty so existing plugins compile unchanged.
+    func carPlayDidDisconnect()
+}
+
+/// Default no-op implementations so adopters only override what they need.
+public extension BeaconLifecycleDelegate {
+    func carPlayDidConnect(transport: String) {}
+    func carPlayDidDisconnect() {}
 }
 
 /// Thread-safe registry for [BeaconLifecycleDelegate] plugins.
@@ -54,6 +68,12 @@ public final class BeaconLifecycleRegistry {
     internal func dispatchEddystoneTimeout(identifier: String, namespace: String, instance: String, distance: Double) {
         snapshot().forEach { $0.eddystoneDidTimeout(identifier: identifier, namespace: namespace, instance: instance, distance: distance) }
     }
+    internal func dispatchCarPlayConnect(transport: String) {
+        snapshot().forEach { $0.carPlayDidConnect(transport: transport) }
+    }
+    internal func dispatchCarPlayDisconnect() {
+        snapshot().forEach { $0.carPlayDidDisconnect() }
+    }
 
     private func snapshot() -> [any BeaconLifecycleDelegate] {
         lock.lock(); defer { lock.unlock() }

package/ios/CarPlayMonitor.swift

@@ -0,0 +1,112 @@
+import Foundation
+import AVFoundation
+import os.log
+
+/// Observes the system audio session for CarPlay route changes and emits
+/// connect/disconnect callbacks. Detection works for both wired and wireless
+/// CarPlay because both expose an output port of type `.carAudio` on the
+/// shared `AVAudioSession`. No CarPlay entitlement is required.
+///
+/// All calls into this class are dispatched onto the main queue. The owning
+/// module is responsible for invoking `start(emit:)` / `stop()` from a
+/// thread-safe context (e.g. Expo module callbacks).
+final class CarPlayMonitor {
+
+    static let shared = CarPlayMonitor()
+
+    /// Emit callback signature: (eventName, payload).
+    typealias Emit = (_ eventName: String, _ payload: [String: Any]) -> Void
+
+    private let log = OSLog(subsystem: "expo.modules.beacon", category: "CarPlayMonitor")
+    private let queue = DispatchQueue.main
+
+    private var observer: NSObjectProtocol?
+    private var emit: Emit?
+    private var isConnected: Bool = false
+
+    private init() {}
+
+    /// Begin observing route changes. Idempotent — calling twice replaces the
+    /// previous emit callback but does not register a duplicate observer.
+    /// Emits an immediate `onCarPlayConnected` event if a CarPlay route is
+    /// already active at the time of the call.
+    func start(emit: @escaping Emit) {
+        queue.async { [weak self] in
+            guard let self = self else { return }
+            self.emit = emit
+            if self.observer == nil {
+                self.observer = NotificationCenter.default.addObserver(
+                    forName: AVAudioSession.routeChangeNotification,
+                    object: nil,
+                    queue: .main
+                ) { [weak self] _ in
+                    self?.handleRouteChange()
+                }
+                os_log("CarPlay monitoring started", log: self.log, type: .info)
+            }
+            // Emit current state if already connected.
+            let (connected, transport) = Self.currentCarPlayState()
+            self.isConnected = connected
+            if connected {
+                self.emitConnected(transport: transport)
+            }
+        }
+    }
+
+    /// Stop observing route changes and clear the emit callback.
+    func stop() {
+        queue.async { [weak self] in
+            guard let self = self else { return }
+            if let token = self.observer {
+                NotificationCenter.default.removeObserver(token)
+                self.observer = nil
+                os_log("CarPlay monitoring stopped", log: self.log, type: .info)
+            }
+            self.emit = nil
+            self.isConnected = false
+        }
+    }
+
+    private func handleRouteChange() {
+        let (connected, transport) = Self.currentCarPlayState()
+        if connected == isConnected { return }
+        isConnected = connected
+        if connected {
+            emitConnected(transport: transport)
+        } else {
+            emitDisconnected()
+        }
+    }
+
+    private func emitConnected(transport: String) {
+        let payload: [String: Any] = [
+            "transport": transport,
+            "timestamp": Date().timeIntervalSince1970 * 1000.0,
+        ]
+        emit?("onCarPlayConnected", payload)
+    }
+
+    private func emitDisconnected() {
+        let payload: [String: Any] = [
+            "timestamp": Date().timeIntervalSince1970 * 1000.0,
+        ]
+        emit?("onCarPlayDisconnected", payload)
+    }
+
+    /// Read the current audio session route and determine whether a CarPlay
+    /// output port is active. Best-effort transport classification:
+    ///   - If a Bluetooth output port is also present, report `"wireless"`.
+    ///   - Else if a CarPlay port is present, report `"wired"`.
+    ///   - Otherwise `"unknown"` (also returned when not connected).
+    private static func currentCarPlayState() -> (connected: Bool, transport: String) {
+        let outputs = AVAudioSession.sharedInstance().currentRoute.outputs
+        let hasCarPlay = outputs.contains { $0.portType == .carAudio }
+        guard hasCarPlay else { return (false, "unknown") }
+        let hasBluetooth = outputs.contains {
+            $0.portType == .bluetoothA2DP ||
+            $0.portType == .bluetoothHFP ||
+            $0.portType == .bluetoothLE
+        }
+        return (true, hasBluetooth ? "wireless" : "wired")
+    }
+}

package/ios/ExpoBeaconModule.swift

@@ -152,7 +152,7 @@ public class ExpoBeaconModule: Module {
             self.migrateUserDefaultsIfNeeded()
         }
 
-        Events("onBeaconEnter", "onBeaconExit", "onBeaconDistance", "onBeaconTimeout", "onBeaconFound", "onEddystoneFound", "onEddystoneEnter", "onEddystoneExit", "onEddystoneDistance", "onEddystoneTimeout", "onBeaconError")
+        Events("onBeaconEnter", "onBeaconExit", "onBeaconDistance", "onBeaconTimeout", "onBeaconFound", "onEddystoneFound", "onEddystoneEnter", "onEddystoneExit", "onEddystoneDistance", "onEddystoneTimeout", "onBeaconError", "onCarPlayConnected", "onCarPlayDisconnected")
 
         // MARK: - Scan
 
@@ -455,6 +455,20 @@ public class ExpoBeaconModule: Module {
             }
         }
 
+        // MARK: - CarPlay
+
+        AsyncFunction("startCarPlayMonitoring") { (promise: Promise) in
+            CarPlayMonitor.shared.start { [weak self] eventName, payload in
+                self?.sendLoggedEvent(eventName, payload)
+            }
+            promise.resolve(nil)
+        }
+
+        AsyncFunction("stopCarPlayMonitoring") { (promise: Promise) in
+            CarPlayMonitor.shared.stop()
+            promise.resolve(nil)
+        }
+
         // MARK: - Continuous Scan
 
         Function("startContinuousScan") { () -> Void in
@@ -599,6 +613,7 @@ public class ExpoBeaconModule: Module {
             self.eventLogger = nil
             self.stopRegionMonitoring()
             self.stopEddystoneMonitoring()
+            CarPlayMonitor.shared.stop()
             self.centralManager?.stopScan()
             self.centralManager = nil
             self.scanTimer?.cancel()
@@ -1128,6 +1143,10 @@ public class ExpoBeaconModule: Module {
                 instance: params["instance"] as? String ?? "",
                 distance: distance
             )
+        case "onCarPlayConnected":
+            r.dispatchCarPlayConnect(transport: params["transport"] as? String ?? "unknown")
+        case "onCarPlayDisconnected":
+            r.dispatchCarPlayDisconnect()
         default:
             break
         }

package/package.json

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

package/plugin/build/withBeaconAndroid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withBeaconAndroid.d.ts","sourceRoot":"","sources":["../src/withBeaconAndroid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAoB,MAAM,sBAAsB,CAAC;AAMtE,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA8BlE;AAqCD,QAAA,MAAM,iBAAiB,EAAE,YA0DxB,CAAC;AAEF,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"withBeaconAndroid.d.ts","sourceRoot":"","sources":["../src/withBeaconAndroid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAoB,MAAM,sBAAsB,CAAC;AAMtE,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAqClE;AAqCD,QAAA,MAAM,iBAAiB,EAAE,YA0DxB,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/plugin/build/withBeaconAndroid.js

@@ -33,6 +33,13 @@ class BeaconGeoPlugin(ctx: Context) : BeaconEventPlugin {
         bgGeo.stop(noOp)
     override fun onEddystoneTimeout(identifier: String, namespace: String, instance: String, distance: Double) =
         bgGeo.stop(noOp)
+    // Start tracking when the device connects to Android Auto, stop when it disconnects.
+    override fun onCarPlayConnected(transport: String) {
+        bgGeo.start(noOp)
+    }
+    override fun onCarPlayDisconnected() {
+        bgGeo.stop(noOp)
+    }
 }
 `;
 }

package/plugin/build/withBeaconIOS.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withBeaconIOS.d.ts","sourceRoot":"","sources":["../src/withBeaconIOS.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAsC,MAAM,sBAAsB,CAAC;AAMxF,wBAAgB,iBAAiB,IAAI,MAAM,CA0B1C;AA+ED,QAAA,MAAM,aAAa,EAAE,YAmEpB,CAAC;AAEF,eAAe,aAAa,CAAC"}
+{"version":3,"file":"withBeaconIOS.d.ts","sourceRoot":"","sources":["../src/withBeaconIOS.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAsC,MAAM,sBAAsB,CAAC;AAMxF,wBAAgB,iBAAiB,IAAI,MAAM,CAkC1C;AA+ED,QAAA,MAAM,aAAa,EAAE,YAmEpB,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/plugin/build/withBeaconIOS.js

@@ -29,6 +29,14 @@ final class BeaconGeoPlugin: BeaconLifecycleDelegate {
     func eddystoneDidTimeout(identifier: String, namespace: String, instance: String, distance: Double) {
         BackgroundGeolocation.sharedInstance().stop()
     }
+    // Start tracking when the device connects to CarPlay (wired or wireless),
+    // stop when it disconnects.
+    func carPlayDidConnect(transport: String) {
+        BackgroundGeolocation.sharedInstance().start()
+    }
+    func carPlayDidDisconnect() {
+        BackgroundGeolocation.sharedInstance().stop()
+    }
 }
 `;
 }

package/src/ExpoBeacon.types.ts

@@ -274,6 +274,27 @@ export type EddystoneTimeoutEvent = {
   distance: number;
 };
 
+/** Transport reported with CarPlay / Android Auto connection events. */
+export type CarPlayTransport =
+  | "wired"      // iOS CarPlay over USB / Lightning
+  | "wireless"   // iOS CarPlay over Bluetooth + Wi-Fi
+  | "projection" // Android Auto projection (phone projecting to head unit)
+  | "native"     // Android Automotive OS (running on the head unit)
+  | "unknown";
+
+/** Payload fired when the device connects to a CarPlay or Android Auto session. */
+export type CarPlayConnectedEvent = {
+  transport: CarPlayTransport;
+  /** Timestamp in milliseconds since epoch. */
+  timestamp: number;
+};
+
+/** Payload fired when the device disconnects from a CarPlay or Android Auto session. */
+export type CarPlayDisconnectedEvent = {
+  /** Timestamp in milliseconds since epoch. */
+  timestamp: number;
+};
+
 /** Payload for native beacon error events (monitoring/ranging failures). */
 export type BeaconErrorEvent = {
   /** Region or constraint identifier, empty string if unavailable. */
@@ -302,6 +323,10 @@ export type ExpoBeaconModuleEvents = {
   onEddystoneTimeout: (params: EddystoneTimeoutEvent) => void;
   /** Fired when a native monitoring or ranging failure occurs (logged to DB and forwarded to JS). */
   onBeaconError: (params: BeaconErrorEvent) => void;
+  /** Fired when the device connects to a CarPlay (iOS) or Android Auto (Android) session. */
+  onCarPlayConnected: (params: CarPlayConnectedEvent) => void;
+  /** Fired when the device disconnects from a CarPlay (iOS) or Android Auto (Android) session. */
+  onCarPlayDisconnected: (params: CarPlayDisconnectedEvent) => void;
 };
 
 /** Options for filtering event logs. */

package/src/ExpoBeaconModule.ts

@@ -189,6 +189,27 @@ declare class ExpoBeaconModule extends NativeModule<ExpoBeaconModuleEvents> {
    * Each field is `null` if not set.
    */
   getApiEndpoint(): { url: string | null; apiKey: string | null; id: string | null };
+
+  /**
+   * Start observing CarPlay (iOS) / Android Auto (Android) connection state.
+   *
+   * Emits `onCarPlayConnected` and `onCarPlayDisconnected` JS events. Events are
+   * also written to the SQLite event log and forwarded to the configured API
+   * endpoint, and dispatched to native lifecycle plugins (used by the auto-
+   * generated geolocation plugin to start/stop background-geolocation).
+   *
+   * Safe to call multiple times — subsequent calls are no-ops.
+   *
+   * - iOS: observes `AVAudioSession.routeChangeNotification` for `.carAudio` ports.
+   *   No CarPlay entitlement required.
+   * - Android: observes `androidx.car.app.connection.CarConnection` LiveData.
+   *   No Android Auto certification required.
+   * - Web: no-op (resolves immediately).
+   */
+  startCarPlayMonitoring(): Promise<void>;
+
+  /** Stop CarPlay / Android Auto connection monitoring started by `startCarPlayMonitoring()`. */
+  stopCarPlayMonitoring(): Promise<void>;
 }
 
 export default requireNativeModule<ExpoBeaconModule>("ExpoBeacon");

package/src/ExpoBeaconModule.web.ts

@@ -54,6 +54,8 @@ const stub = {
   getApiEndpoint: (): { url: string | null; apiKey: string | null; id: string | null } => notSupported(),
   isBatteryOptimizationExempt: (): boolean => true,
   requestBatteryOptimizationExemption: (): Promise<boolean> => Promise.resolve(true),
+  startCarPlayMonitoring: (): Promise<void> => Promise.resolve(),
+  stopCarPlayMonitoring: (): Promise<void> => Promise.resolve(),
   addListener: (_eventName: keyof ExpoBeaconModuleEvents, _listener: any) => ({
     remove: () => {},
   }),

package/src/index.ts

@@ -24,4 +24,7 @@ export type {
   EddystoneTimeoutEvent,
   EventLogQueryOptions,
   EventLogEntry,
+  CarPlayTransport,
+  CarPlayConnectedEvent,
+  CarPlayDisconnectedEvent,
 } from "./ExpoBeacon.types";