expo-beacon 0.10.3 → 0.10.4

package/README.md

@@ -1844,8 +1844,8 @@ type NotificationConfig = {
 ```ts
 type BeaconNotificationSettings = {
   events?: BeaconNotificationConfig;
-  foregroundService?: ForegroundServiceConfig; // Android only
-  channel?: NotificationChannelConfig;         // Android only
+  foregroundService?: ForegroundServiceConfig; // Android only, title/text/icon only
+  channel?: NotificationChannelConfig;         // Android only, beacon alert channel
 };
 ```
 
@@ -1854,8 +1854,8 @@ type BeaconNotificationSettings = {
 ```ts
 type CarPlayNotificationSettings = {
   events?: CarPlayNotificationConfig;
-  foregroundService?: ForegroundServiceConfig; // Android only, CarPlay-only mode
-  channel?: CarPlayChannelConfig;              // Android only
+  foregroundService?: ForegroundServiceConfig; // Android only, CarPlay-only title/text/icon
+  channel?: CarPlayChannelConfig;              // Android only, CarPlay alert channel
 };
 ```
 
@@ -1884,6 +1884,8 @@ type ForegroundServiceConfig = {
 };
 ```
 
+Foreground service notifications always use the dedicated Android channel `expo_beacon_foreground_channel`, created with low importance and no sound/vibration. This config only changes the notification content.
+
 ### `NotificationChannelConfig`
 
 ```ts
@@ -2222,6 +2224,8 @@ Local notifications are posted automatically for beacon enter/exit/timeout event
 | Foreground service text | `"Monitoring for iBeacons in the background"` |
 | CarPlay-only foreground title | `"Connected device monitoring active"` |
 | CarPlay-only foreground text | `"Monitoring connected vehicle (CarPlay/Android Auto)"` |
+| Foreground channel name (Android) | `"Beacon Foreground Service"` |
+| Foreground channel importance (Android) | `"low"` (no sound/vibration) |
 | Channel name (Android) | `"Beacon Monitoring"` |
 | Channel importance (Android) | `"low"` |
 | CarPlay channel name (Android) | `"CarPlay / Android Auto"` |
@@ -2229,7 +2233,7 @@ Local notifications are posted automatically for beacon enter/exit/timeout event
 
 ### Android Channels
 
-Beacon foreground-service and event notifications use the channel ID `expo_beacon_channel`. CarPlay / Android Auto event notifications use `expo_beacon_carplay_channel`; when Android runs in CarPlay-only mode, the foreground-service notification also uses the CarPlay channel and `carPlay.foregroundService` config.
+Foreground-service notifications use their own quiet channel ID, `expo_beacon_foreground_channel`, so the persistent status notification does not make sound or vibrate. Beacon event notifications use `expo_beacon_channel`; CarPlay / Android Auto event notifications use `expo_beacon_carplay_channel`. In CarPlay-only mode, the foreground-service notification still uses the quiet foreground channel but reads title/text/icon from `carPlay.foregroundService`.
 
 > **Android channel importance note**: Android prevents decreasing channel importance after the first notification. Increasing works; decreasing has no effect until the user clears notification settings or reinstalls the app.
 

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 FOREGROUND_CHANNEL_ID = "expo_beacon_foreground_channel"
 private const val CARPLAY_CHANNEL_ID = "expo_beacon_carplay_channel"
 internal const val FOREGROUND_NOTIF_ID = 1001
 /**
@@ -102,6 +103,7 @@ class BeaconForegroundService : Service(), BeaconConsumer {
     override fun onCreate() {
         super.onCreate()
         activeService = this
+        ensureForegroundNotificationChannel(this)
         ensureNotificationChannel(this)
         ensureCarPlayNotificationChannel(this)
         apiForwarder = BeaconApiForwarder(this)
@@ -1239,6 +1241,7 @@ class BeaconForegroundService : Service(), BeaconConsumer {
                     .edit()
                     .putBoolean(MONITORING_ACTIVE_KEY, true)
                     .apply()
+            ensureForegroundNotificationChannel(context)
             ensureNotificationChannel(context)
             ensureCarPlayNotificationChannel(context)
             val intent = Intent(context, BeaconForegroundService::class.java)
@@ -1307,6 +1310,7 @@ class BeaconForegroundService : Service(), BeaconConsumer {
          */
         fun enableCarPlay(context: Context) {
             setCarPlayEnabled(context, true)
+            ensureForegroundNotificationChannel(context)
             ensureNotificationChannel(context)
             ensureCarPlayNotificationChannel(context)
             // Arm the WorkManager watchdog (15-min periodic safety net) and the
@@ -1570,12 +1574,38 @@ class BeaconForegroundService : Service(), BeaconConsumer {
                         NotificationManager.IMPORTANCE_DEFAULT
                 )
 
+        /**
+         * Ensure the persistent foreground-service notification has a quiet channel of its own.
+         * Event channels can be default/high importance, but the always-on service status should
+         * never make sound or vibrate.
+         */
+        fun ensureForegroundNotificationChannel(context: Context) {
+            if (Build.VERSION.SDK_INT < Build.VERSION_CODES.O) return
+            val notifMgr = context.getSystemService(NotificationManager::class.java)
+            if (notifMgr?.getNotificationChannel(FOREGROUND_CHANNEL_ID) == null) {
+                val channel =
+                        NotificationChannel(
+                                        FOREGROUND_CHANNEL_ID,
+                                        "Beacon Foreground Service",
+                                        NotificationManager.IMPORTANCE_LOW
+                                )
+                                .apply {
+                                    description =
+                                            "Persistent status for beacon and CarPlay background monitoring"
+                                    setSound(null, null)
+                                    enableVibration(false)
+                                }
+                notifMgr?.createNotificationChannel(channel)
+            }
+        }
+
         /**
          * Build the persistent foreground-service notification from any Context. Static so
          * cold-start paths that run before a service instance exists (e.g. [BootReceiver]) read the
          * same persisted config.
          */
         fun buildForegroundNotification(context: Context): Notification {
+            ensureForegroundNotificationChannel(context)
             val config = readNotificationConfig(context)
 
             // If beacon monitoring is not active and the service is alive only
@@ -1605,16 +1635,15 @@ class BeaconForegroundService : Service(), BeaconConsumer {
                                 "foregroundService"
                         )
                     }
-            val channelId = if (carPlayOnly) CARPLAY_CHANNEL_ID else CHANNEL_ID
-
             val title = fgConfig?.optString("title")?.takeIf { it.isNotEmpty() } ?: defaultTitle
             val text = fgConfig?.optString("text")?.takeIf { it.isNotEmpty() } ?: defaultText
 
-            return NotificationCompat.Builder(context, channelId)
+            return NotificationCompat.Builder(context, FOREGROUND_CHANNEL_ID)
                     .setSmallIcon(resolveIconRes(context, fgConfig))
                     .setContentTitle(title)
                     .setContentText(text)
                     .setPriority(NotificationCompat.PRIORITY_LOW)
+                    .setSilent(true)
                     .setOngoing(true)
                     .build()
         }

package/package.json

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