expo-beacon 0.8.2 → 0.8.3

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

@@ -19,6 +19,7 @@ import org.altbeacon.beacon.*
 import org.json.JSONArray
 
 private const val CHANNEL_ID = "expo_beacon_channel"
+private const val CARPLAY_CHANNEL_ID = "expo_beacon_carplay_channel"
 internal const val FOREGROUND_NOTIF_ID = 1001
 /**
  * Base ID for per-beacon enter/exit notifications; incremented per unique region.
@@ -26,6 +27,14 @@ internal const val FOREGROUND_NOTIF_ID = 1001
  * before ID collision. Sufficient for real-world beacon deployments.
  */
 private const val ENTER_EXIT_NOTIF_BASE_ID = 2000
+/**
+ * Fixed notification IDs for CarPlay connect / disconnect events. Each event
+ * type uses a single ID so repeated events of the same type replace the prior
+ * notification rather than stacking, while connect and disconnect remain
+ * independently visible.
+ */
+private const val CARPLAY_CONNECTED_NOTIF_ID = 3000
+private const val CARPLAY_DISCONNECTED_NOTIF_ID = 3001
 
 class BeaconForegroundService : Service(), BeaconConsumer {
 
@@ -94,6 +103,7 @@ class BeaconForegroundService : Service(), BeaconConsumer {
         super.onCreate()
         activeService = this
         createNotificationChannel()
+        createCarPlayNotificationChannel()
         apiForwarder = BeaconApiForwarder(this)
         beaconManager = BeaconManager.getInstanceForApplication(this).also { manager ->
             BeaconParsers.ensureRegistered(manager)
@@ -856,6 +866,60 @@ class BeaconForegroundService : Service(), BeaconConsumer {
         }
         // Best-effort delivery to the live JS bridge if a module instance is bound.
         try { boundModule?.get()?.forwardCarPlayEventFromService(eventName, payload) } catch (_: Throwable) {}
+        // Local notification for connect/disconnect (config-gated).
+        try {
+            when (eventName) {
+                "onCarPlayConnected" -> showCarPlayNotification(
+                    "connected",
+                    payload["transport"] as? String,
+                )
+                "onCarPlayDisconnected" -> showCarPlayNotification("disconnected", null)
+            }
+        } catch (e: Throwable) {
+            Log.w(TAG, "CarPlay notification post failed", e)
+        }
+    }
+
+    private fun showCarPlayNotification(eventType: String, transport: String?) {
+        val config = readNotificationConfig()
+        val eventsConfig = config.optJSONObject("carPlayEvents")
+
+        // Respect the enabled flag (defaults to true)
+        if (eventsConfig != null && !eventsConfig.optBoolean("enabled", true)) return
+
+        val defaultTitle = if (eventType == "connected") "CarPlay Connected" else "CarPlay Disconnected"
+        val title = when (eventType) {
+            "connected" -> eventsConfig?.optString("connectedTitle")?.takeIf { it.isNotEmpty() } ?: defaultTitle
+            else -> eventsConfig?.optString("disconnectedTitle")?.takeIf { it.isNotEmpty() } ?: defaultTitle
+        }
+
+        val bodyTemplate = eventsConfig?.optString("body")?.takeIf { it.isNotEmpty() }
+            ?: "CarPlay session {event}"
+        val message = bodyTemplate
+            .replace("{event}", eventType)
+            .replace("{transport}", transport ?: "")
+
+        val iconName = eventsConfig?.optString("icon")?.takeIf { it.isNotEmpty() }
+        val iconResId = iconName?.let { name ->
+            try { resources.getIdentifier(name, "drawable", packageName).takeIf { it != 0 } }
+            catch (_: Exception) { null }
+        } ?: android.R.drawable.ic_dialog_info
+
+        val notification = NotificationCompat.Builder(this, CARPLAY_CHANNEL_ID)
+            .setSmallIcon(iconResId)
+            .setContentTitle(title)
+            .setContentText(message)
+            .setPriority(NotificationCompat.PRIORITY_DEFAULT)
+            .setAutoCancel(true)
+            .build()
+
+        val notifId = if (eventType == "connected") CARPLAY_CONNECTED_NOTIF_ID
+                      else CARPLAY_DISCONNECTED_NOTIF_ID
+        try {
+            NotificationManagerCompat.from(this).notify(notifId, notification)
+        } catch (_: SecurityException) {
+            // POST_NOTIFICATIONS not granted — silently skip notification
+        }
     }
 
     private fun createNotificationChannel() {
@@ -884,6 +948,31 @@ class BeaconForegroundService : Service(), BeaconConsumer {
         }
     }
 
+    private fun createCarPlayNotificationChannel() {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            val config = readNotificationConfig()
+            val channelConfig = config.optJSONObject("carPlayChannel")
+
+            val channelName = channelConfig?.optString("name")?.takeIf { it.isNotEmpty() }
+                ?: "CarPlay / Android Auto"
+            val channelDesc = channelConfig?.optString("description")?.takeIf { it.isNotEmpty() }
+                ?: "CarPlay and Android Auto connect/disconnect notifications"
+            val importance = when (channelConfig?.optString("importance")) {
+                "high" -> NotificationManager.IMPORTANCE_HIGH
+                "low" -> NotificationManager.IMPORTANCE_LOW
+                else -> NotificationManager.IMPORTANCE_DEFAULT
+            }
+
+            val notifMgr = getSystemService(NotificationManager::class.java)
+            if (notifMgr?.getNotificationChannel(CARPLAY_CHANNEL_ID) == null) {
+                val channel = NotificationChannel(CARPLAY_CHANNEL_ID, channelName, importance).apply {
+                    description = channelDesc
+                }
+                notifMgr?.createNotificationChannel(channel)
+            }
+        }
+    }
+
     private fun buildForegroundNotification(): Notification {
         return Companion.buildForegroundNotification(this)
     }
@@ -926,6 +1015,7 @@ class BeaconForegroundService : Service(), BeaconConsumer {
             context.getSharedPreferences(PREF_IS_MONITORING, Context.MODE_PRIVATE)
                 .edit().putBoolean("active", true).apply()
             ensureNotificationChannel(context)
+            ensureCarPlayNotificationChannel(context)
             val intent = Intent(context, BeaconForegroundService::class.java)
             if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
                 context.startForegroundService(intent)
@@ -976,6 +1066,7 @@ class BeaconForegroundService : Service(), BeaconConsumer {
         fun enableCarPlay(context: Context) {
             setCarPlayEnabled(context, true)
             ensureNotificationChannel(context)
+            ensureCarPlayNotificationChannel(context)
             val intent = Intent(context, BeaconForegroundService::class.java)
                 .setAction(ACTION_ENABLE_CARPLAY)
             if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
@@ -1050,6 +1141,38 @@ class BeaconForegroundService : Service(), BeaconConsumer {
             }
         }
 
+        /**
+         * Ensure the CarPlay notification channel exists. Mirrors
+         * [ensureNotificationChannel] for the dedicated CarPlay channel so that
+         * users can mute CarPlay notifications independently in system settings.
+         */
+        fun ensureCarPlayNotificationChannel(context: Context) {
+            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+                val json = context.getSharedPreferences(NOTIFICATION_CONFIG_PREFS, Context.MODE_PRIVATE)
+                    .getString("config", null)
+                val config = try { org.json.JSONObject(json ?: "") } catch (_: Exception) { org.json.JSONObject() }
+                val channelConfig = config.optJSONObject("carPlayChannel")
+
+                val channelName = channelConfig?.optString("name")?.takeIf { it.isNotEmpty() }
+                    ?: "CarPlay / Android Auto"
+                val channelDesc = channelConfig?.optString("description")?.takeIf { it.isNotEmpty() }
+                    ?: "CarPlay and Android Auto connect/disconnect notifications"
+                val importance = when (channelConfig?.optString("importance")) {
+                    "high" -> NotificationManager.IMPORTANCE_HIGH
+                    "low" -> NotificationManager.IMPORTANCE_LOW
+                    else -> NotificationManager.IMPORTANCE_DEFAULT
+                }
+
+                val notifMgr = context.getSystemService(NotificationManager::class.java)
+                if (notifMgr?.getNotificationChannel(CARPLAY_CHANNEL_ID) == null) {
+                    val channel = NotificationChannel(CARPLAY_CHANNEL_ID, channelName, importance).apply {
+                        description = channelDesc
+                    }
+                    notifMgr?.createNotificationChannel(channel)
+                }
+            }
+        }
+
         /**
          * Build the foreground notification from any Context (service or module).
          * Shared so that ExpoBeaconModule can pass the same notification to

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

@@ -7,6 +7,10 @@ import android.util.Log
 import androidx.car.app.connection.CarConnection
 import androidx.lifecycle.LiveData
 import androidx.lifecycle.Observer
+import java.text.SimpleDateFormat
+import java.util.Date
+import java.util.Locale
+import java.util.TimeZone
 
 /**
  * Wraps [CarConnection] LiveData to surface Android Auto / Automotive OS
@@ -72,6 +76,8 @@ internal class CarPlayMonitor(private val context: Context) {
         if (lastConnected == connected) return
         lastConnected = connected
         val callback = emit ?: return
+        val now = System.currentTimeMillis()
+        val nowIso = formatIso(now)
         if (connected) {
             val transport = when (type) {
                 CarConnection.CONNECTION_TYPE_PROJECTION -> "projection"
@@ -80,15 +86,24 @@ internal class CarPlayMonitor(private val context: Context) {
             }
             callback("onCarPlayConnected", mapOf(
                 "transport" to transport,
-                "timestamp" to System.currentTimeMillis(),
+                "timestamp" to now,
+                "timestampIso" to nowIso,
             ))
         } else {
             callback("onCarPlayDisconnected", mapOf(
-                "timestamp" to System.currentTimeMillis(),
+                "timestamp" to now,
+                "timestampIso" to nowIso,
             ))
         }
     }
 
+    private fun formatIso(millis: Long): String {
+        // SimpleDateFormat is not thread-safe — synchronize on the shared instance.
+        synchronized(ISO_FORMAT) {
+            return ISO_FORMAT.format(Date(millis))
+        }
+    }
+
     private fun runOnMain(block: () -> Unit) {
         if (Looper.myLooper() == Looper.getMainLooper()) {
             block()
@@ -99,5 +114,9 @@ internal class CarPlayMonitor(private val context: Context) {
 
     private companion object {
         const val TAG = "CarPlayMonitor"
+        // ISO 8601 UTC with millisecond precision. Safe for all supported APIs (minSdk 23).
+        private val ISO_FORMAT = SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'", Locale.US).apply {
+            timeZone = TimeZone.getTimeZone("UTC")
+        }
     }
 }

package/build/ExpoBeacon.types.d.ts

@@ -104,14 +104,50 @@ export type NotificationChannelConfig = {
      */
     importance?: "low" | "default" | "high";
 };
+/** Configuration for CarPlay / Android Auto connect/disconnect notifications. */
+export type CarPlayNotificationConfig = {
+    /** Whether to show CarPlay connect/disconnect notifications. Default: true. */
+    enabled?: boolean;
+    /** Notification title on CarPlay/Android Auto connect. Default: "CarPlay Connected". */
+    connectedTitle?: string;
+    /** Notification title on CarPlay/Android Auto disconnect. Default: "CarPlay Disconnected". */
+    disconnectedTitle?: string;
+    /**
+     * Notification body template. Supports `{event}` ("connected"/"disconnected") and
+     * `{transport}` (e.g. "wired", "wireless", "projection", "native", "unknown") placeholders.
+     * Note: `{transport}` is only meaningful for connect events; on disconnect it is replaced with an empty string.
+     * Default: "CarPlay session {event}".
+     */
+    body?: string;
+    /** Play a sound with the notification (iOS only). Default: true. */
+    sound?: boolean;
+    /** Android drawable resource name for the notification icon (e.g. "ic_notification"). */
+    icon?: string;
+};
+/** Configuration for the Android notification channel used for CarPlay events. */
+export type CarPlayChannelConfig = {
+    /** Channel display name shown in system settings. Default: "CarPlay / Android Auto". */
+    name?: string;
+    /** Channel description shown in system settings. Default: "CarPlay and Android Auto connect/disconnect notifications". */
+    description?: string;
+    /**
+     * Channel importance level. Default: 'default' (so connect/disconnect events make a sound).
+     * Note: Android may ignore decreases in importance after first channel creation until the app is reinstalled.
+     */
+    importance?: "low" | "default" | "high";
+};
 /** Combined notification configuration for all notification types. */
 export type NotificationConfig = {
     /** Settings for beacon enter/exit event notifications. */
     beaconEvents?: BeaconNotificationConfig;
+    /** Settings for CarPlay / Android Auto connect/disconnect notifications. */
+    carPlayEvents?: CarPlayNotificationConfig;
     /** Settings for the persistent foreground service notification (Android only). */
     foregroundService?: ForegroundServiceConfig;
     /** Settings for the Android notification channel (Android only). */
     channel?: NotificationChannelConfig;
+    /** Settings for the Android notification channel used for CarPlay events (Android only). */
+    carPlayChannel?: CarPlayChannelConfig;
 };
 /** Snapshot of the current monitoring configuration and active state. */
 export type MonitoringConfig = {
@@ -261,11 +297,15 @@ export type CarPlayConnectedEvent = {
     transport: CarPlayTransport;
     /** Timestamp in milliseconds since epoch. */
     timestamp: number;
+    /** ISO 8601 UTC representation of {@link timestamp} (e.g. "2026-05-12T14:23:45.678Z"). */
+    timestampIso?: string;
 };
 /** Payload fired when the device disconnects from a CarPlay or Android Auto session. */
 export type CarPlayDisconnectedEvent = {
     /** Timestamp in milliseconds since epoch. */
     timestamp: number;
+    /** ISO 8601 UTC representation of {@link timestamp} (e.g. "2026-05-12T14:23:45.678Z"). */
+    timestampIso?: string;
 };
 /** Payload for native beacon error events (monitoring/ranging failures). */
 export type BeaconErrorEvent = {

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/** 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"]}
+{"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/** Configuration for CarPlay / Android Auto connect/disconnect notifications. */\r\nexport type CarPlayNotificationConfig = {\r\n  /** Whether to show CarPlay connect/disconnect notifications. Default: true. */\r\n  enabled?: boolean;\r\n  /** Notification title on CarPlay/Android Auto connect. Default: \"CarPlay Connected\". */\r\n  connectedTitle?: string;\r\n  /** Notification title on CarPlay/Android Auto disconnect. Default: \"CarPlay Disconnected\". */\r\n  disconnectedTitle?: string;\r\n  /**\r\n   * Notification body template. Supports `{event}` (\"connected\"/\"disconnected\") and\r\n   * `{transport}` (e.g. \"wired\", \"wireless\", \"projection\", \"native\", \"unknown\") placeholders.\r\n   * Note: `{transport}` is only meaningful for connect events; on disconnect it is replaced with an empty string.\r\n   * Default: \"CarPlay session {event}\".\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 notification channel used for CarPlay events. */\r\nexport type CarPlayChannelConfig = {\r\n  /** Channel display name shown in system settings. Default: \"CarPlay / Android Auto\". */\r\n  name?: string;\r\n  /** Channel description shown in system settings. Default: \"CarPlay and Android Auto connect/disconnect notifications\". */\r\n  description?: string;\r\n  /**\r\n   * Channel importance level. Default: 'default' (so connect/disconnect events make a sound).\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 CarPlay / Android Auto connect/disconnect notifications. */\r\n  carPlayEvents?: CarPlayNotificationConfig;\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  /** Settings for the Android notification channel used for CarPlay events (Android only). */\r\n  carPlayChannel?: CarPlayChannelConfig;\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  /** ISO 8601 UTC representation of {@link timestamp} (e.g. \"2026-05-12T14:23:45.678Z\"). */\r\n  timestampIso?: string;\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  /** ISO 8601 UTC representation of {@link timestamp} (e.g. \"2026-05-12T14:23:45.678Z\"). */\r\n  timestampIso?: string;\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/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, CarPlayTransport, CarPlayConnectedEvent, CarPlayDisconnectedEvent, } from "./ExpoBeacon.types";
+export type { BeaconScanResult, PairedBeacon, BeaconRegionEvent, BeaconDistanceEvent, BeaconTimeoutEvent, ExpoBeaconModuleEvents, NotificationConfig, MonitoringOptions, MonitoringConfig, MonitoredDeviceState, BeaconNotificationConfig, CarPlayNotificationConfig, CarPlayChannelConfig, 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,EACb,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,GACzB,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,yBAAyB,EACzB,oBAAoB,EACpB,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  CarPlayTransport,\r\n  CarPlayConnectedEvent,\r\n  CarPlayDisconnectedEvent,\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  CarPlayNotificationConfig,\r\n  CarPlayChannelConfig,\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/CarPlayMonitor.swift

@@ -20,6 +20,16 @@ final class CarPlayMonitor {
     private let log = OSLog(subsystem: "expo.modules.beacon", category: "CarPlayMonitor")
     private let queue = DispatchQueue.main
 
+    /// Cached ISO8601 formatter (UTC, fractional seconds). Reused across emits
+    /// to avoid per-event allocation. `ISO8601DateFormatter` is documented as
+    /// thread-safe.
+    private static let isoFormatter: ISO8601DateFormatter = {
+        let f = ISO8601DateFormatter()
+        f.formatOptions = [.withInternetDateTime, .withFractionalSeconds]
+        f.timeZone = TimeZone(identifier: "UTC")
+        return f
+    }()
+
     private var observer: NSObjectProtocol?
     private var emit: Emit?
     private var isConnected: Bool = false
@@ -170,16 +180,20 @@ final class CarPlayMonitor {
     }
 
     private func emitConnected(transport: String) {
+        let now = Date()
         let payload: [String: Any] = [
             "transport": transport,
-            "timestamp": Date().timeIntervalSince1970 * 1000.0,
+            "timestamp": now.timeIntervalSince1970 * 1000.0,
+            "timestampIso": Self.isoFormatter.string(from: now),
         ]
         emit?("onCarPlayConnected", payload)
     }
 
     private func emitDisconnected() {
+        let now = Date()
         let payload: [String: Any] = [
-            "timestamp": Date().timeIntervalSince1970 * 1000.0,
+            "timestamp": now.timeIntervalSince1970 * 1000.0,
+            "timestampIso": Self.isoFormatter.string(from: now),
         ]
         emit?("onCarPlayDisconnected", payload)
     }

package/ios/ExpoBeaconModule+CarPlay.swift

@@ -7,7 +7,19 @@ extension ExpoBeaconModule {
     /// (see `CarPlayMonitor.start(emit:)` semantics).
     func startCarPlayMonitoringInternal() {
         CarPlayMonitor.shared.start { [weak self] eventName, payload in
-            self?.sendLoggedEvent(eventName, payload)
+            guard let self = self else { return }
+            self.sendLoggedEvent(eventName, payload)
+            switch eventName {
+            case "onCarPlayConnected":
+                self.postCarPlayNotification(
+                    eventType: "connected",
+                    transport: payload["transport"] as? String
+                )
+            case "onCarPlayDisconnected":
+                self.postCarPlayNotification(eventType: "disconnected", transport: nil)
+            default:
+                break
+            }
         }
         // Tier 2 fallback: subscribe to background-wake signals so suspended
         // apps still notice CarPlay route changes that happened off-process.

package/ios/ExpoBeaconModule+Notifications.swift

@@ -46,6 +46,48 @@ extension ExpoBeaconModule {
         UNUserNotificationCenter.current().add(request, withCompletionHandler: nil)
     }
 
+    /// Post a local notification when a CarPlay session connects or disconnects.
+    /// `eventType` is `"connected"` or `"disconnected"`. `transport` is the
+    /// transport string from the connect payload (e.g. "wired", "wireless");
+    /// pass `nil` on disconnect — the `{transport}` body placeholder is then
+    /// substituted with an empty string.
+    func postCarPlayNotification(eventType: String, transport: String?) {
+        let cfg = loadNotificationConfig()
+        let eventsCfg = cfg["carPlayEvents"] as? [String: Any]
+
+        // Respect the enabled flag (defaults to true)
+        if let enabled = eventsCfg?["enabled"] as? Bool, !enabled { return }
+
+        let defaultTitle = eventType == "connected" ? "CarPlay Connected" : "CarPlay Disconnected"
+        let title: String
+        switch eventType {
+        case "connected":
+            title = (eventsCfg?["connectedTitle"] as? String).flatMap { $0.isEmpty ? nil : $0 } ?? defaultTitle
+        default:
+            title = (eventsCfg?["disconnectedTitle"] as? String).flatMap { $0.isEmpty ? nil : $0 } ?? defaultTitle
+        }
+
+        let bodyTemplate = (eventsCfg?["body"] as? String).flatMap { $0.isEmpty ? nil : $0 }
+            ?? "CarPlay session {event}"
+        let body = bodyTemplate
+            .replacingOccurrences(of: "{event}", with: eventType)
+            .replacingOccurrences(of: "{transport}", with: transport ?? "")
+
+        let content = UNMutableNotificationContent()
+        content.title = title
+        content.body = body
+
+        let playSound = eventsCfg?["sound"] as? Bool ?? true
+        if playSound { content.sound = .default }
+
+        let request = UNNotificationRequest(
+            identifier: "carplay_\(eventType)_\(Date().timeIntervalSince1970)",
+            content: content,
+            trigger: nil
+        )
+        UNUserNotificationCenter.current().add(request, withCompletionHandler: nil)
+    }
+
     func loadNotificationConfig() -> [String: Any] {
         guard let json = self.defaults.string(forKey: NOTIFICATION_CONFIG_KEY),
               let data = json.data(using: .utf8) else { return [:] }

package/package.json

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

package/src/ExpoBeacon.types.ts

@@ -112,14 +112,52 @@ export type NotificationChannelConfig = {
   importance?: "low" | "default" | "high";
 };
 
+/** Configuration for CarPlay / Android Auto connect/disconnect notifications. */
+export type CarPlayNotificationConfig = {
+  /** Whether to show CarPlay connect/disconnect notifications. Default: true. */
+  enabled?: boolean;
+  /** Notification title on CarPlay/Android Auto connect. Default: "CarPlay Connected". */
+  connectedTitle?: string;
+  /** Notification title on CarPlay/Android Auto disconnect. Default: "CarPlay Disconnected". */
+  disconnectedTitle?: string;
+  /**
+   * Notification body template. Supports `{event}` ("connected"/"disconnected") and
+   * `{transport}` (e.g. "wired", "wireless", "projection", "native", "unknown") placeholders.
+   * Note: `{transport}` is only meaningful for connect events; on disconnect it is replaced with an empty string.
+   * Default: "CarPlay session {event}".
+   */
+  body?: string;
+  /** Play a sound with the notification (iOS only). Default: true. */
+  sound?: boolean;
+  /** Android drawable resource name for the notification icon (e.g. "ic_notification"). */
+  icon?: string;
+};
+
+/** Configuration for the Android notification channel used for CarPlay events. */
+export type CarPlayChannelConfig = {
+  /** Channel display name shown in system settings. Default: "CarPlay / Android Auto". */
+  name?: string;
+  /** Channel description shown in system settings. Default: "CarPlay and Android Auto connect/disconnect notifications". */
+  description?: string;
+  /**
+   * Channel importance level. Default: 'default' (so connect/disconnect events make a sound).
+   * Note: Android may ignore decreases in importance after first channel creation until the app is reinstalled.
+   */
+  importance?: "low" | "default" | "high";
+};
+
 /** Combined notification configuration for all notification types. */
 export type NotificationConfig = {
   /** Settings for beacon enter/exit event notifications. */
   beaconEvents?: BeaconNotificationConfig;
+  /** Settings for CarPlay / Android Auto connect/disconnect notifications. */
+  carPlayEvents?: CarPlayNotificationConfig;
   /** Settings for the persistent foreground service notification (Android only). */
   foregroundService?: ForegroundServiceConfig;
   /** Settings for the Android notification channel (Android only). */
   channel?: NotificationChannelConfig;
+  /** Settings for the Android notification channel used for CarPlay events (Android only). */
+  carPlayChannel?: CarPlayChannelConfig;
 };
 
 /** Snapshot of the current monitoring configuration and active state. */
@@ -287,12 +325,16 @@ export type CarPlayConnectedEvent = {
   transport: CarPlayTransport;
   /** Timestamp in milliseconds since epoch. */
   timestamp: number;
+  /** ISO 8601 UTC representation of {@link timestamp} (e.g. "2026-05-12T14:23:45.678Z"). */
+  timestampIso?: string;
 };
 
 /** Payload fired when the device disconnects from a CarPlay or Android Auto session. */
 export type CarPlayDisconnectedEvent = {
   /** Timestamp in milliseconds since epoch. */
   timestamp: number;
+  /** ISO 8601 UTC representation of {@link timestamp} (e.g. "2026-05-12T14:23:45.678Z"). */
+  timestampIso?: string;
 };
 
 /** Payload for native beacon error events (monitoring/ranging failures). */

package/src/index.ts

@@ -14,6 +14,8 @@ export type {
   MonitoringConfig,
   MonitoredDeviceState,
   BeaconNotificationConfig,
+  CarPlayNotificationConfig,
+  CarPlayChannelConfig,
   ForegroundServiceConfig,
   NotificationChannelConfig,
   EddystoneFrameType,