expo-beacon 0.10.3 → 0.10.5

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.5",
   "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

@@ -1,4 +1,4 @@
-import { ConfigPlugin } from '@expo/config-plugins';
+import { ConfigPlugin } from "@expo/config-plugins";
 /**
  * Categories advertised in the generated `automotive_app_desc.xml` resource.
  * - `template` — declares the app as a Car-App-Library template provider. This
@@ -11,7 +11,7 @@ import { ConfigPlugin } from '@expo/config-plugins';
  *   package as AA-aware for connection detection. Use this when the consumer
  *   app shouldn't appear in the AA drawer at all.
  */
-export type AndroidAutoUsesName = 'template' | 'media' | 'notification';
+export type AndroidAutoUsesName = "template" | "media" | "notification";
 export type BeaconAndroidPluginProps = {
     /**
      * Generate `BeaconGeoPlugin.kt` and register it in `MainApplication.kt` so

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

@@ -1 +1 @@
-{"version":3,"file":"withBeaconAndroid.d.ts","sourceRoot":"","sources":["../src/withBeaconAndroid.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,YAAY,EAGb,MAAM,sBAAsB,CAAC;AAM9B;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,OAAO,GAAG,cAAc,CAAC;AAExE,MAAM,MAAM,wBAAwB,GAAG;IACrC;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;;;;;;;;;OAUG;IACH,WAAW,CAAC,EAAE;QACZ;2EACmE;QACnE,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB;qCAC6B;QAC7B,QAAQ,CAAC,EAAE,mBAAmB,CAAC;KAChC,CAAC;CACH,CAAC;AAIF,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAqClE;AA+LD,QAAA,MAAM,iBAAiB,EAAE,YAAY,CAAC,wBAAwB,GAAG,IAAI,CAyBpE,CAAC;AAEF,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"withBeaconAndroid.d.ts","sourceRoot":"","sources":["../src/withBeaconAndroid.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,YAAY,EAGb,MAAM,sBAAsB,CAAC;AAM9B;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,OAAO,GAAG,cAAc,CAAC;AAExE,MAAM,MAAM,wBAAwB,GAAG;IACrC;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;;;;;;;;;OAUG;IACH,WAAW,CAAC,EAAE;QACZ;2EACmE;QACnE,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB;qCAC6B;QAC7B,QAAQ,CAAC,EAAE,mBAAmB,CAAC;KAChC,CAAC;CACH,CAAC;AAIF,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAsDlE;AAoMD,QAAA,MAAM,iBAAiB,EAAE,YAAY,CAAC,wBAAwB,GAAG,IAAI,CA0BpE,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/plugin/build/withBeaconAndroid.js

@@ -12,6 +12,8 @@ package ${packageName}
 import android.content.Context
 import com.transistorsoft.locationmanager.adapter.BackgroundGeolocation
 import com.transistorsoft.locationmanager.adapter.callback.TSCallback
+import com.transistorsoft.locationmanager.adapter.callback.TSSyncCallback
+import com.transistorsoft.locationmanager.location.TSLocation
 import expo.modules.beacon.BeaconEventPlugin
 
 class BeaconGeoPlugin(ctx: Context) : BeaconEventPlugin {
@@ -20,56 +22,71 @@ class BeaconGeoPlugin(ctx: Context) : BeaconEventPlugin {
         override fun onSuccess() {}
         override fun onFailure(error: String) {}
     }
+    private val noOpSync = object : TSSyncCallback {
+        override fun onSuccess(records: MutableList<TSLocation>) {}
+        override fun onFailure(error: String) {}
+    }
 
-    override fun onBeaconEnter(identifier: String, uuid: String, major: Int, minor: Int, distance: Double) =
+    private fun startTracking() {
         bgGeo.start(noOp)
-    override fun onBeaconExit(identifier: String, uuid: String, major: Int, minor: Int, distance: Double) =
+        bgGeo.changePace(true, noOp)
+    }
+
+    private fun stopTracking() {
+        bgGeo.sync(noOpSync)
+        bgGeo.changePace(false, noOp)
         bgGeo.stop(noOp)
+    }
+
+    override fun onBeaconEnter(identifier: String, uuid: String, major: Int, minor: Int, distance: Double) =
+        startTracking()
+    override fun onBeaconExit(identifier: String, uuid: String, major: Int, minor: Int, distance: Double) =
+        stopTracking()
     override fun onBeaconTimeout(identifier: String, uuid: String, major: Int, minor: Int, distance: Double) =
-        bgGeo.stop(noOp)
+        stopTracking()
     override fun onEddystoneEnter(identifier: String, namespace: String, instance: String, distance: Double) =
-        bgGeo.start(noOp)
+        startTracking()
     override fun onEddystoneExit(identifier: String, namespace: String, instance: String, distance: Double) =
-        bgGeo.stop(noOp)
+        stopTracking()
     override fun onEddystoneTimeout(identifier: String, namespace: String, instance: String, distance: Double) =
-        bgGeo.stop(noOp)
+        stopTracking()
     // Start tracking when the device connects to Android Auto, stop when it disconnects.
     override fun onCarPlayConnected(transport: String) {
-        bgGeo.start(noOp)
+        startTracking()
     }
     override fun onCarPlayDisconnected() {
-        bgGeo.stop(noOp)
+        stopTracking()
     }
 }
 `;
 }
 // ─── Helpers ──────────────────────────────────────────────────────────────────
 function modifyMainApplication(contents) {
-    const importLine = 'import expo.modules.beacon.BeaconPluginRegistry';
+    const importLine = "import expo.modules.beacon.BeaconPluginRegistry";
     // Add missing import after the last existing import.
     if (!contents.includes(importLine)) {
-        const lines = contents.split('\n');
-        const lastImportIdx = lines.reduce((last, line, i) => (line.trimStart().startsWith('import ') ? i : last), -1);
+        const lines = contents.split("\n");
+        const lastImportIdx = lines.reduce((last, line, i) => (line.trimStart().startsWith("import ") ? i : last), -1);
         if (lastImportIdx >= 0) {
             lines.splice(lastImportIdx + 1, 0, importLine);
         }
         else {
-            const pkgIdx = lines.findIndex((l) => l.startsWith('package '));
-            lines.splice(pkgIdx >= 0 ? pkgIdx + 1 : 0, 0, '', importLine);
+            const pkgIdx = lines.findIndex((l) => l.startsWith("package "));
+            lines.splice(pkgIdx >= 0 ? pkgIdx + 1 : 0, 0, "", importLine);
         }
-        contents = lines.join('\n');
+        contents = lines.join("\n");
     }
     // Add registration call immediately after `super.onCreate()`.
-    const registration = '    BeaconPluginRegistry.register(BeaconGeoPlugin(this))';
-    if (!contents.includes('BeaconPluginRegistry.register(BeaconGeoPlugin(this))')) {
+    const registration = "    BeaconPluginRegistry.register(BeaconGeoPlugin(this))";
+    if (!contents.includes("BeaconPluginRegistry.register(BeaconGeoPlugin(this))")) {
         contents = contents.replace(/(super\.onCreate\(\)[ \t]*\n)/, `$1${registration}\n`);
     }
     return contents;
 }
 // ─── Plugin ───────────────────────────────────────────────────────────────────
-const AA_META_DATA_NAME = 'com.google.android.gms.car.application';
-const AA_META_DATA_RESOURCE = '@xml/automotive_app_desc';
-const AA_RES_FILE = 'automotive_app_desc.xml';
+const AA_META_DATA_NAME = "com.google.android.gms.car.application";
+const AA_META_DATA_RESOURCE = "@xml/automotive_app_desc";
+const AA_RES_FILE = "automotive_app_desc.xml";
 function getAutomotiveAppDescXml(usesName) {
     return `<?xml version="1.0" encoding="utf-8"?>
 <!--
@@ -98,7 +115,7 @@ const withAndroidAutoMetaData = (config) => {
             // User-managed entry; leave it alone.
             return config;
         }
-        config_plugins_1.AndroidConfig.Manifest.addMetaDataItemToMainApplication(app, AA_META_DATA_NAME, AA_META_DATA_RESOURCE, 'resource');
+        config_plugins_1.AndroidConfig.Manifest.addMetaDataItemToMainApplication(app, AA_META_DATA_NAME, AA_META_DATA_RESOURCE, "resource");
         return config;
     });
 };
@@ -109,9 +126,9 @@ const withAndroidAutoMetaData = (config) => {
  */
 function withAndroidAutoDescriptor(usesName) {
     return (config) => (0, config_plugins_1.withDangerousMod)(config, [
-        'android',
+        "android",
         (config) => {
-            const xmlDir = path.join(config.modRequest.platformProjectRoot, 'app/src/main/res/xml');
+            const xmlDir = path.join(config.modRequest.platformProjectRoot, "app/src/main/res/xml");
             const xmlPath = path.join(xmlDir, AA_RES_FILE);
             if (fs.existsSync(xmlPath)) {
                 // Don't clobber a user-managed resource.
@@ -135,47 +152,47 @@ function withAndroidAutoDescriptor(usesName) {
 const withBeaconGeoPlugin = (config) => {
     // Step 1 – write BeaconGeoPlugin.kt into the app source tree.
     config = (0, config_plugins_1.withDangerousMod)(config, [
-        'android',
+        "android",
         (config) => {
             var _a;
             const pkgName = (_a = config.android) === null || _a === void 0 ? void 0 : _a.package;
             if (!pkgName) {
-                console.warn('[expo-beacon] android.package not set — BeaconGeoPlugin.kt was not written.');
+                console.warn("[expo-beacon] android.package not set — BeaconGeoPlugin.kt was not written.");
                 return config;
             }
-            const pkgPath = pkgName.replace(/\./g, '/');
-            const outputPath = path.join(config.modRequest.platformProjectRoot, 'app/src/main/java', pkgPath, 'BeaconGeoPlugin.kt');
+            const pkgPath = pkgName.replace(/\./g, "/");
+            const outputPath = path.join(config.modRequest.platformProjectRoot, "app/src/main/java", pkgPath, "BeaconGeoPlugin.kt");
             fs.writeFileSync(outputPath, getAndroidPluginKotlin(pkgName));
             return config;
         },
     ]);
     // Step 2 – patch MainApplication (Kotlin only) to call register().
     config = (0, config_plugins_1.withDangerousMod)(config, [
-        'android',
+        "android",
         (config) => {
             var _a;
             const pkgName = (_a = config.android) === null || _a === void 0 ? void 0 : _a.package;
             if (!pkgName)
                 return config;
-            const pkgPath = pkgName.replace(/\./g, '/');
-            const javaRoot = path.join(config.modRequest.platformProjectRoot, 'app/src/main/java', pkgPath);
+            const pkgPath = pkgName.replace(/\./g, "/");
+            const javaRoot = path.join(config.modRequest.platformProjectRoot, "app/src/main/java", pkgPath);
             const mainAppPath = [
-                path.join(javaRoot, 'MainApplication.kt'),
-                path.join(javaRoot, 'MainApplication.java'),
+                path.join(javaRoot, "MainApplication.kt"),
+                path.join(javaRoot, "MainApplication.java"),
             ].find(fs.existsSync);
             if (!mainAppPath) {
-                console.warn('[expo-beacon] MainApplication.kt / .java not found — ' +
-                    'please add BeaconPluginRegistry.register(BeaconGeoPlugin(this)) manually.');
+                console.warn("[expo-beacon] MainApplication.kt / .java not found — " +
+                    "please add BeaconPluginRegistry.register(BeaconGeoPlugin(this)) manually.");
                 return config;
             }
             // The injected import + registration use Kotlin syntax and would corrupt
             // a Java MainApplication — leave Java projects untouched.
-            if (mainAppPath.endsWith('.java')) {
-                console.warn('[expo-beacon] MainApplication.java (Java) cannot be patched automatically — ' +
-                    'please add BeaconPluginRegistry.register(BeaconGeoPlugin(this)) manually.');
+            if (mainAppPath.endsWith(".java")) {
+                console.warn("[expo-beacon] MainApplication.java (Java) cannot be patched automatically — " +
+                    "please add BeaconPluginRegistry.register(BeaconGeoPlugin(this)) manually.");
                 return config;
             }
-            const original = fs.readFileSync(mainAppPath, 'utf-8');
+            const original = fs.readFileSync(mainAppPath, "utf-8");
             fs.writeFileSync(mainAppPath, modifyMainApplication(original));
             return config;
         },
@@ -186,7 +203,7 @@ const withBeaconAndroid = (config, props) => {
     var _a, _b, _c, _d, _e;
     const opts = props !== null && props !== void 0 ? props : {};
     const aaRegister = (_b = (_a = opts.androidAuto) === null || _a === void 0 ? void 0 : _a.register) !== null && _b !== void 0 ? _b : true;
-    const aaUsesName = (_d = (_c = opts.androidAuto) === null || _c === void 0 ? void 0 : _c.usesName) !== null && _d !== void 0 ? _d : 'template';
+    const aaUsesName = (_d = (_c = opts.androidAuto) === null || _c === void 0 ? void 0 : _c.usesName) !== null && _d !== void 0 ? _d : "template";
     // Steps 1–2 – BeaconGeoPlugin generation + MainApplication registration
     // (react-native-background-geolocation integration). Opt-out via
     // `backgroundGeolocation: false`.

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

@@ -1 +1 @@
-{"version":3,"file":"withBeaconIOS.d.ts","sourceRoot":"","sources":["../src/withBeaconIOS.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAKb,MAAM,sBAAsB,CAAC;AAM9B,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;;;;;;;;;;;;;OAcG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAIF,wBAAgB,iBAAiB,IAAI,MAAM,CA4C1C;AA2KD,QAAA,MAAM,aAAa,EAAE,YAAY,CAAC,oBAAoB,GAAG,IAAI,CAgC5D,CAAC;AA6CF,eAAe,aAAa,CAAC"}
+{"version":3,"file":"withBeaconIOS.d.ts","sourceRoot":"","sources":["../src/withBeaconIOS.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAKb,MAAM,sBAAsB,CAAC;AAM9B,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;;;;;;;;;;;;;OAcG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAIF,wBAAgB,iBAAiB,IAAI,MAAM,CA6C1C;AA2KD,QAAA,MAAM,aAAa,EAAE,YAAY,CAAC,oBAAoB,GAAG,IAAI,CAgC5D,CAAC;AA6CF,eAAe,aAAa,CAAC"}

package/plugin/build/withBeaconIOS.js

@@ -17,6 +17,7 @@ final class BeaconGeoPlugin: BeaconLifecycleDelegate {
   }
 
   private func stopTracking() {
+    BackgroundGeolocation.sharedInstance().sync()
     BackgroundGeolocation.sharedInstance().changePace(false)
     BackgroundGeolocation.sharedInstance().stop()
   }