expo-beacon 0.1.0 → 0.2.0

package/README.md

@@ -276,28 +276,46 @@ paired.forEach((b) =>
 
 ---
 
-### `startMonitoring(maxDistance?)`
+### `startMonitoring(options?)`
 
 ```ts
-startMonitoring(maxDistance?: number): Promise<void>
+startMonitoring(options?: MonitoringOptions | number): Promise<void>
 ```
 
 Starts background region monitoring for all paired beacons.
 
-| Parameter     | Type     | Default      | Description                                                                                   |
-| ------------- | -------- | ------------ | --------------------------------------------------------------------------------------------- |
-| `maxDistance` | `number` | `undefined`  | Optional distance threshold in metres. `onBeaconEnter` is only emitted when the measured distance is ≤ this value. `onBeaconExit` is always emitted. Omit to disable distance filtering. |
+Accepts either a `MonitoringOptions` object or a plain `number` (backward-compatible shorthand for `maxDistance`).
+
+**`MonitoringOptions`**
+
+| Property        | Type                 | Default     | Description                                                                                   |
+| --------------- | -------------------- | ----------- | --------------------------------------------------------------------------------------------- |
+| `maxDistance`   | `number`             | `undefined` | Optional distance threshold in metres. `onBeaconEnter` is only emitted when the measured distance is ≤ this value. `onBeaconExit` is always emitted. Omit to disable distance filtering. |
+| `notifications` | `NotificationConfig` | `undefined` | Notification config overrides applied for this session. Persisted and takes effect immediately. |
 
 **Android**: Launches `BeaconForegroundService` — a persistent foreground service required by Android 8+ for background BLE. Restarts automatically after device reboot.
 
 **iOS**: Activates `CLLocationManager` region monitoring. iOS can wake or relaunch the app when a region boundary is crossed, even if the app is terminated.
 
 ```ts
-// Monitor with no distance limit
-await ExpoBeacon.startMonitoring();
-
-// Only fire enter events when within 5 metres
+// Backward-compatible shorthand (number = maxDistance)
 await ExpoBeacon.startMonitoring(5);
+
+// Full options object
+await ExpoBeacon.startMonitoring({
+  maxDistance: 5,
+  notifications: {
+    beaconEvents: {
+      enterTitle: "Beacon nearby!",
+      body: "{identifier} is within range",
+    },
+  },
+});
+
+// Monitor with no distance limit and no enter/exit notifications
+await ExpoBeacon.startMonitoring({
+  notifications: { beaconEvents: { enabled: false } },
+});
 ```
 
 > Call `requestPermissionsAsync()` before `startMonitoring()`.
@@ -318,6 +336,48 @@ await ExpoBeacon.stopMonitoring();
 
 ---
 
+### `setNotificationConfig(config)`
+
+```ts
+setNotificationConfig(config: NotificationConfig): void
+```
+
+Persists notification configuration that is applied to all subsequent monitoring sessions. Values are stored in `SharedPreferences` (Android) / `UserDefaults` (iOS) and survive app restarts.
+
+For one-off overrides tied to a single session, pass `notifications` directly in [`startMonitoring(options)`](#startmonitoringoptions) instead — it calls this function automatically.
+
+```ts
+ExpoBeacon.setNotificationConfig({
+  // Enter/exit alert notifications
+  beaconEvents: {
+    enabled: true,                    // false to suppress all enter/exit notifications
+    enterTitle: "Beacon nearby",
+    exitTitle: "Beacon out of range",
+    body: "{identifier} {event}ed",   // {identifier} and {event} are replaced at runtime
+    sound: true,                      // iOS only — default true
+    icon: "ic_beacon_notification",   // Android only — drawable resource name
+  },
+
+  // Persistent status-bar notification while monitoring is active (Android only)
+  foregroundService: {
+    title: "My App is watching",
+    text: "Monitoring for nearby beacons",
+    icon: "ic_service",               // Android drawable resource name
+  },
+
+  // Android notification channel settings
+  channel: {
+    name: "Proximity Alerts",
+    description: "Alerts when beacons enter or leave range",
+    importance: "default",            // "low" | "default" | "high"
+  },
+});
+```
+
+> **Android channel importance note**: Android prevents decreasing channel importance once a user has been notified. Increasing importance always works; decreasing it will have no effect until the user clears the app's notification settings or reinstalls the app.
+
+---
+
 ## Events
 
 Subscribe to events using `ExpoBeacon.addListener(eventName, handler)`. Always call `.remove()` on the subscription when your component unmounts.
@@ -476,6 +536,71 @@ type BeaconDistanceEvent = {
 
 ---
 
+### `MonitoringOptions`
+
+Passed to `startMonitoring(options)`.
+
+```ts
+type MonitoringOptions = {
+  maxDistance?: number;           // Distance threshold in metres for enter events
+  notifications?: NotificationConfig; // Notification overrides for this session
+};
+```
+
+### `NotificationConfig`
+
+Top-level config object accepted by `setNotificationConfig()` and `startMonitoring({ notifications })`.
+
+```ts
+type NotificationConfig = {
+  beaconEvents?: BeaconNotificationConfig;
+  foregroundService?: ForegroundServiceConfig;  // Android only
+  channel?: NotificationChannelConfig;          // Android only
+};
+```
+
+### `BeaconNotificationConfig`
+
+Controls the enter/exit alert notifications.
+
+```ts
+type BeaconNotificationConfig = {
+  enabled?: boolean;     // false to disable all enter/exit notifications. Default: true
+  enterTitle?: string;   // Default: "Beacon Entered"
+  exitTitle?: string;    // Default: "Beacon Exited"
+  body?: string;         // Template — {identifier} and {event} are replaced at runtime
+                         // Default: "{identifier} region {event}ed"
+  sound?: boolean;       // iOS only — play notification sound. Default: true
+  icon?: string;         // Android only — drawable resource name (e.g. "ic_notification")
+};
+```
+
+### `ForegroundServiceConfig`
+
+Controls the persistent Android status-bar notification while monitoring is active.
+
+```ts
+type ForegroundServiceConfig = {
+  title?: string;  // Default: "Beacon Monitoring Active"
+  text?: string;   // Default: "Monitoring for iBeacons in the background"
+  icon?: string;   // Android drawable resource name
+};
+```
+
+### `NotificationChannelConfig`
+
+Controls the Android notification channel shown in system settings.
+
+```ts
+type NotificationChannelConfig = {
+  name?: string;                          // Default: "Beacon Monitoring"
+  description?: string;                   // Default: "Used for background iBeacon region monitoring"
+  importance?: "low" | "default" | "high"; // Default: "low"
+};
+```
+
+---
+
 ## Background Behaviour
 
 ### Android
@@ -494,14 +619,30 @@ Default scan timing: 1.1 s scan window every 5 s.
 
 ## Notifications
 
-A local notification is posted for every `onBeaconEnter` and `onBeaconExit` event.
+A local notification is posted for every `onBeaconEnter` and `onBeaconExit` event. All notification settings can be customised via [`setNotificationConfig()`](#setnotificationconfigconfig) or inline in [`startMonitoring(options)`](#startmonitoringoptions).
+
+### Defaults
+
+| Property                       | Default value                                    |
+| ------------------------------ | ------------------------------------------------ |
+| Enter title                    | `"Beacon Entered"`                               |
+| Exit title                     | `"Beacon Exited"`                                |
+| Body                           | `"{identifier} region {event}ed"`                |
+| Sound (iOS)                    | `true`                                           |
+| Icon (Android)                 | System `ic_dialog_info`                          |
+| Foreground service title       | `"Beacon Monitoring Active"`                     |
+| Foreground service text        | `"Monitoring for iBeacons in the background"`    |
+| Channel name (Android)         | `"Beacon Monitoring"`                            |
+| Channel importance (Android)   | `"low"`                                          |
+
+### Channel IDs (Android)
 
 | Channel / type                  | Importance          |
 | ------------------------------- | ------------------- |
-| Foreground service (Android)    | `IMPORTANCE_LOW`    |
-| Enter / exit alerts             | `IMPORTANCE_DEFAULT`|
+| Foreground service (Android)    | configurable (default `low`) |
+| Enter / exit alerts             | configurable (default `default`) |
 
-Both channels share the id `expo_beacon_channel`.
+Both notifications share the channel id `expo_beacon_channel`. The channel is recreated on each `onStartCommand` so config changes take effect on the next monitoring start.
 
 ---
 

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

@@ -70,7 +70,8 @@ class BeaconForegroundService : Service(), BeaconConsumer {
                 )
             }
             // Use continuous scanning (not JobScheduler) for foreground service
-            manager.setEnableScheduledScanJobs(false)
+            // Guard: throws if called after ranging/monitoring has already started
+            try { manager.setEnableScheduledScanJobs(false) } catch (_: IllegalStateException) {}
             manager.setBackgroundBetweenScanPeriod(5000L)  // 5s between scans
             manager.setBackgroundScanPeriod(1100L)         // 1.1s scan window
             manager.setForegroundScanPeriod(1000L)         // 1s scan window for distance logging
@@ -231,11 +232,33 @@ class BeaconForegroundService : Service(), BeaconConsumer {
     }
 
     private fun showEnterExitNotification(region: Region, eventType: String) {
-        val title = if (eventType == "enter") "Beacon Entered" else "Beacon Exited"
-        val message = "${region.uniqueId} region ${eventType}ed"
+        val config = readNotificationConfig()
+        val eventsConfig = config.optJSONObject("beaconEvents")
+
+        // Respect the enabled flag (defaults to true)
+        if (eventsConfig != null && !eventsConfig.optBoolean("enabled", true)) return
+
+        val defaultTitle = if (eventType == "enter") "Beacon Entered" else "Beacon Exited"
+        val title = if (eventType == "enter") {
+            eventsConfig?.optString("enterTitle")?.takeIf { it.isNotEmpty() } ?: defaultTitle
+        } else {
+            eventsConfig?.optString("exitTitle")?.takeIf { it.isNotEmpty() } ?: defaultTitle
+        }
+
+        val bodyTemplate = eventsConfig?.optString("body")?.takeIf { it.isNotEmpty() }
+            ?: "{identifier} region {event}ed"
+        val message = bodyTemplate
+            .replace("{identifier}", region.uniqueId)
+            .replace("{event}", eventType)
+
+        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, CHANNEL_ID)
-            .setSmallIcon(android.R.drawable.ic_dialog_info)
+            .setSmallIcon(iconResId)
             .setContentTitle(title)
             .setContentText(message)
             .setPriority(NotificationCompat.PRIORITY_DEFAULT)
@@ -251,27 +274,58 @@ class BeaconForegroundService : Service(), BeaconConsumer {
 
     private fun createNotificationChannel() {
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
-            val channel = NotificationChannel(
-                CHANNEL_ID,
-                "Beacon Monitoring",
-                NotificationManager.IMPORTANCE_LOW
-            ).apply {
-                description = "Used for background iBeacon region monitoring"
+            val config = readNotificationConfig()
+            val channelConfig = config.optJSONObject("channel")
+
+            val channelName = channelConfig?.optString("name")?.takeIf { it.isNotEmpty() }
+                ?: "Beacon Monitoring"
+            val channelDesc = channelConfig?.optString("description")?.takeIf { it.isNotEmpty() }
+                ?: "Used for background iBeacon region monitoring"
+            val importance = when (channelConfig?.optString("importance")) {
+                "high" -> NotificationManager.IMPORTANCE_HIGH
+                "default" -> NotificationManager.IMPORTANCE_DEFAULT
+                else -> NotificationManager.IMPORTANCE_LOW
             }
-            getSystemService(NotificationManager::class.java)?.createNotificationChannel(channel)
+
+            val notifMgr = getSystemService(NotificationManager::class.java)
+            // Delete and recreate so config changes take effect
+            notifMgr?.deleteNotificationChannel(CHANNEL_ID)
+            val channel = NotificationChannel(CHANNEL_ID, channelName, importance).apply {
+                description = channelDesc
+            }
+            notifMgr?.createNotificationChannel(channel)
         }
     }
 
     private fun buildForegroundNotification(): Notification {
+        val config = readNotificationConfig()
+        val fgConfig = config.optJSONObject("foregroundService")
+
+        val title = fgConfig?.optString("title")?.takeIf { it.isNotEmpty() }
+            ?: "Beacon Monitoring Active"
+        val text = fgConfig?.optString("text")?.takeIf { it.isNotEmpty() }
+            ?: "Monitoring for iBeacons in the background"
+        val iconName = fgConfig?.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
+
         return NotificationCompat.Builder(this, CHANNEL_ID)
-            .setSmallIcon(android.R.drawable.ic_dialog_info)
-            .setContentTitle("Beacon Monitoring Active")
-            .setContentText("Monitoring for iBeacons in the background")
+            .setSmallIcon(iconResId)
+            .setContentTitle(title)
+            .setContentText(text)
             .setPriority(NotificationCompat.PRIORITY_LOW)
             .setOngoing(true)
             .build()
     }
 
+    private fun readNotificationConfig(): org.json.JSONObject {
+        val json = getSharedPreferences("expo.beacon.notification_config", Context.MODE_PRIVATE)
+            .getString("config", null) ?: return org.json.JSONObject()
+        return try { org.json.JSONObject(json) } catch (_: Exception) { org.json.JSONObject() }
+    }
+
     override fun onDestroy() {
         beaconManager.removeMonitorNotifier(monitorNotifier)
         beaconManager.removeRangeNotifier(rangeNotifier)

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

@@ -21,15 +21,20 @@ import org.json.JSONObject
 
 private const val PREFS_NAME = "expo.beacon.paired"
 private const val PREFS_KEY = "paired_beacons"
+private const val NOTIFICATION_CONFIG_PREFS = "expo.beacon.notification_config"
 
 class ExpoBeaconModule : Module(), BeaconConsumer {
 
     private val beaconManager: BeaconManager by lazy {
         BeaconManager.getInstanceForApplication(appContext.reactContext!!).also { manager ->
+            // Must be configured before any bind/ranging starts
+            manager.setEnableScheduledScanJobs(false)
             // Register iBeacon layout parser
-            manager.beaconParsers.add(
-                BeaconParser().setBeaconLayout("m:2-3=0215,i:4-19,i:20-21,i:22-23,p:24-24,d:25-25")
-            )
+            if (manager.beaconParsers.none { it.layout?.contains("0215") == true }) {
+                manager.beaconParsers.add(
+                    BeaconParser().setBeaconLayout("m:2-3=0215,i:4-19,i:20-21,i:22-23,p:24-24,d:25-25")
+                )
+            }
         }
     }
 
@@ -149,8 +154,23 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
             }
         }
 
-        AsyncFunction("startMonitoring") { maxDistance: Double?, promise: Promise ->
+        AsyncFunction("startMonitoring") { options: Any?, promise: Promise ->
             val ctx = appContext.reactContext!!
+            var maxDistance: Double? = null
+            when (options) {
+                is Double -> maxDistance = options
+                is Map<*, *> -> {
+                    @Suppress("UNCHECKED_CAST")
+                    val map = options as Map<String, Any?>
+                    maxDistance = (map["maxDistance"] as? Number)?.toDouble()
+                    val notifications = map["notifications"]
+                    if (notifications is Map<*, *>) {
+                        @Suppress("UNCHECKED_CAST")
+                        ctx.getSharedPreferences(NOTIFICATION_CONFIG_PREFS, Context.MODE_PRIVATE)
+                            .edit().putString("config", mapToJson(notifications as Map<String, Any?>).toString()).apply()
+                    }
+                }
+            }
             ctx.getSharedPreferences("expo.beacon.monitoring_options", Context.MODE_PRIVATE)
                 .edit().apply {
                     if (maxDistance != null) putFloat("max_distance", maxDistance.toFloat())
@@ -161,6 +181,13 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
             promise.resolve(null)
         }
 
+        Function("setNotificationConfig") { config: Map<String, Any?> ->
+            val ctx = appContext.reactContext!!
+            ctx.getSharedPreferences(NOTIFICATION_CONFIG_PREFS, Context.MODE_PRIVATE)
+                .edit().putString("config", mapToJson(config).toString()).apply()
+            null
+        }
+
         AsyncFunction("stopMonitoring") { promise: Promise ->
             BeaconForegroundService.stop(appContext.reactContext!!)
             unregisterEventReceiver()
@@ -284,6 +311,23 @@ class ExpoBeaconModule : Module(), BeaconConsumer {
         scanPromise = null
     }
 
+    // --- Notification config helpers ---
+
+    private fun mapToJson(map: Map<String, Any?>): JSONObject {
+        val json = JSONObject()
+        map.forEach { (key, value) ->
+            when (value) {
+                null -> json.put(key, JSONObject.NULL)
+                is Map<*, *> -> {
+                    @Suppress("UNCHECKED_CAST")
+                    json.put(key, mapToJson(value as Map<String, Any?>))
+                }
+                else -> json.put(key, value)
+            }
+        }
+        return json
+    }
+
     // --- Shared Preferences helpers ---
 
     private fun loadPairedBeaconsJson(): JSONArray {

package/build/ExpoBeacon.types.d.ts

@@ -41,6 +41,64 @@ export type BeaconDistanceEvent = {
     minor: number;
     distance: number;
 };
+/** Configuration for beacon enter/exit event notifications. */
+export type BeaconNotificationConfig = {
+    /** Whether to show enter/exit notifications. Default: true. */
+    enabled?: boolean;
+    /** Notification title on beacon enter. Default: "Beacon Entered". */
+    enterTitle?: string;
+    /** Notification title on beacon exit. Default: "Beacon Exited". */
+    exitTitle?: string;
+    /**
+     * Notification body template. Supports {identifier} and {event} placeholders.
+     * Default: "{identifier} region {event}ed".
+     */
+    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 foreground service notification (persistent status bar entry). */
+export type ForegroundServiceConfig = {
+    /** Title of the persistent notification. Default: "Beacon Monitoring Active". */
+    title?: string;
+    /** Body text of the persistent notification. Default: "Monitoring for iBeacons in the background". */
+    text?: string;
+    /** Android drawable resource name for the notification icon. */
+    icon?: string;
+};
+/** Configuration for the Android notification channel. */
+export type NotificationChannelConfig = {
+    /** Channel display name shown in system settings. Default: "Beacon Monitoring". */
+    name?: string;
+    /** Channel description shown in system settings. Default: "Used for background iBeacon region monitoring". */
+    description?: string;
+    /**
+     * Channel importance level. Default: 'low'.
+     * 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 the persistent foreground service notification (Android only). */
+    foregroundService?: ForegroundServiceConfig;
+    /** Settings for the Android notification channel (Android only). */
+    channel?: NotificationChannelConfig;
+};
+/** Options accepted by startMonitoring(). */
+export type MonitoringOptions = {
+    /**
+     * Maximum distance in metres for distance-based enter events.
+     * Exit events are always emitted when the region is lost.
+     */
+    maxDistance?: number;
+    /** Notification configuration overrides to apply for this monitoring session. */
+    notifications?: NotificationConfig;
+};
 /** Module event map. */
 export type ExpoBeaconModuleEvents = {
     onBeaconEnter: (params: BeaconRegionEvent) => void;

package/build/ExpoBeacon.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoBeacon.types.d.ts","sourceRoot":"","sources":["../src/ExpoBeacon.types.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,+DAA+D;AAC/D,MAAM,MAAM,YAAY,GAAG;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,4CAA4C;AAC5C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,4DAA4D;AAC5D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,qEAAqE;AACrE,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAwB;AACxB,MAAM,MAAM,sBAAsB,GAAG;IACnC,aAAa,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACnD,YAAY,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAClD,eAAe,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACtD,gBAAgB,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACxD,wEAAwE;IACxE,aAAa,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACnD,CAAC"}
+{"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};\r\n\r\n/** A beacon that has been paired/registered for monitoring. */\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};\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};\r\n\r\n/** Payload for ranging events (beacon proximity update). */\r\nexport type BeaconRangingEvent = {\r\n  identifier: string;\r\n  uuid: string;\r\n  major: number;\r\n  minor: number;\r\n  rssi: number;\r\n  distance: 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};\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  onBeaconRanging: (params: BeaconRangingEvent) => void;\r\n  onBeaconDistance: (params: BeaconDistanceEvent) => void;\r\n  /** Fired continuously during a live scan as each beacon is detected. */\r\n  onBeaconFound: (params: BeaconScanResult) => void;\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};\r\n\r\n/** A beacon that has been paired/registered for monitoring. */\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};\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};\r\n\r\n/** Payload for ranging events (beacon proximity update). */\r\nexport type BeaconRangingEvent = {\r\n  identifier: string;\r\n  uuid: string;\r\n  major: number;\r\n  minor: number;\r\n  rssi: number;\r\n  distance: 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};\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  /**\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/** 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  /** Notification configuration overrides to apply for this monitoring session. */\r\n  notifications?: NotificationConfig;\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  onBeaconRanging: (params: BeaconRangingEvent) => void;\r\n  onBeaconDistance: (params: BeaconDistanceEvent) => void;\r\n  /** Fired continuously during a live scan as each beacon is detected. */\r\n  onBeaconFound: (params: BeaconScanResult) => void;\r\n};\r\n"]}

package/build/ExpoBeaconModule.d.ts

@@ -1,46 +1,2 @@
-import { NativeModule } from "expo";
-import { ExpoBeaconModuleEvents, BeaconScanResult, PairedBeacon } from "./ExpoBeacon.types";
-declare class ExpoBeaconModule extends NativeModule<ExpoBeaconModuleEvents> {
-    /**
-     * Start a one-shot BLE scan. Resolves with discovered beacons after scanDuration ms.
-     * @param scanDuration Duration in ms (default 5000)
-     */
-    scanForBeaconsAsync(scanDuration?: number): Promise<BeaconScanResult[]>;
-    /**
-     * Register a beacon for persistent region monitoring.
-     */
-    pairBeacon(identifier: string, uuid: string, major: number, minor: number): void;
-    /**
-     * Remove a previously paired beacon.
-     */
-    unpairBeacon(identifier: string): void;
-    /**
-     * Return all currently paired beacons.
-     */
-    getPairedBeacons(): PairedBeacon[];
-    /**
-     * Start background region monitoring for all paired beacons.
-     * On Android starts a foreground service.
-     * On iOS starts CLLocationManager region monitoring.
-     * @param maxDistance Optional distance threshold in metres. Enter events are only
-     *   emitted when the beacon is measured to be within this distance.
-     *   Exit events are always emitted when the beacon region is lost.
-     */
-    startMonitoring(maxDistance?: number): Promise<void>;
-    /**
-     * Stop background region monitoring.
-     */
-    stopMonitoring(): Promise<void>;
-    /**
-     * Start a continuous BLE scan. Fires `onBeaconFound` events as beacons are detected.
-     * Call stopContinuousScan() to end the scan.
-     */
-    startContinuousScan(): void;
-    /** Stop the continuous scan started by startContinuousScan(). */
-    stopContinuousScan(): void;
-    /** Request Bluetooth + Location permissions. Returns true if granted. */
-    requestPermissionsAsync(): Promise<boolean>;
-}
-declare const _default: ExpoBeaconModule;
-export default _default;
+export default module;
 //# sourceMappingURL=ExpoBeaconModule.d.ts.map

package/build/ExpoBeaconModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoBeaconModule.d.ts","sourceRoot":"","sources":["../src/ExpoBeaconModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,MAAM,CAAC;AAEzD,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,YAAY,EACb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,OAAO,gBAAiB,SAAQ,YAAY,CAAC,sBAAsB,CAAC;IACzE;;;OAGG;IACH,mBAAmB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAEvE;;OAEG;IACH,UAAU,CACR,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,IAAI;IAEP;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAEtC;;OAEG;IACH,gBAAgB,IAAI,YAAY,EAAE;IAElC;;;;;;;OAOG;IACH,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAEpD;;OAEG;IACH,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAE/B;;;OAGG;IACH,mBAAmB,IAAI,IAAI;IAE3B,iEAAiE;IACjE,kBAAkB,IAAI,IAAI;IAE1B,yEAAyE;IACzE,uBAAuB,IAAI,OAAO,CAAC,OAAO,CAAC;CAC5C;;AAED,wBAAmE"}
+{"version":3,"file":"ExpoBeaconModule.d.ts","sourceRoot":"","sources":["../src/ExpoBeaconModule.ts"],"names":[],"mappings":"AAiFA,eAAe,MAAM,CAAC"}

package/build/ExpoBeaconModule.js

@@ -1,3 +1,11 @@
 import { requireNativeModule } from "expo";
-export default requireNativeModule("ExpoBeacon");
+try {
+    // eslint-disable-next-line import/no-mutable-exports
+    var module = requireNativeModule("ExpoBeacon");
+}
+catch {
+    throw new Error("expo-beacon: native module not found. Make sure you are using a development build " +
+        "(not Expo Go) and have run `npx expo prebuild` followed by a native rebuild.");
+}
+export default module;
 //# sourceMappingURL=ExpoBeaconModule.js.map

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;AA+DzD,eAAe,mBAAmB,CAAmB,YAAY,CAAC,CAAC","sourcesContent":["import { NativeModule, requireNativeModule } from \"expo\";\r\n\r\nimport {\r\n  ExpoBeaconModuleEvents,\r\n  BeaconScanResult,\r\n  PairedBeacon,\r\n} from \"./ExpoBeacon.types\";\r\n\r\ndeclare class ExpoBeaconModule extends NativeModule<ExpoBeaconModuleEvents> {\r\n  /**\r\n   * Start a one-shot BLE scan. Resolves with discovered beacons after scanDuration ms.\r\n   * @param scanDuration Duration in ms (default 5000)\r\n   */\r\n  scanForBeaconsAsync(scanDuration?: number): Promise<BeaconScanResult[]>;\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  ): 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   * 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   * @param maxDistance Optional distance threshold in metres. Enter events are only\r\n   *   emitted when the beacon is measured to be within this distance.\r\n   *   Exit events are always emitted when the beacon region is lost.\r\n   */\r\n  startMonitoring(maxDistance?: 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  /** Request Bluetooth + Location permissions. Returns true if granted. */\r\n  requestPermissionsAsync(): Promise<boolean>;\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;AAuEzD,IAAI,CAAC;IACH,qDAAqD;IACrD,IAAI,MAAM,GAAG,mBAAmB,CAAmB,YAAY,CAAC,CAAC;AACnE,CAAC;AAAC,MAAM,CAAC;IACP,MAAM,IAAI,KAAK,CACb,oFAAoF;QAClF,8EAA8E,CACjF,CAAC;AACJ,CAAC;AAED,eAAe,MAAM,CAAC","sourcesContent":["import { NativeModule, requireNativeModule } from \"expo\";\r\n\r\nimport {\r\n  ExpoBeaconModuleEvents,\r\n  BeaconScanResult,\r\n  PairedBeacon,\r\n  NotificationConfig,\r\n  MonitoringOptions,\r\n} from \"./ExpoBeacon.types\";\r\n\r\ndeclare class ExpoBeaconModule extends NativeModule<ExpoBeaconModuleEvents> {\r\n  /**\r\n   * Start a one-shot BLE scan. Resolves with discovered beacons after scanDuration ms.\r\n   * @param scanDuration Duration in ms (default 5000)\r\n   */\r\n  scanForBeaconsAsync(scanDuration?: number): Promise<BeaconScanResult[]>;\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  ): 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   * 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  /** Request Bluetooth + Location permissions. Returns true if granted. */\r\n  requestPermissionsAsync(): Promise<boolean>;\r\n}\r\n\r\ntry {\r\n  // eslint-disable-next-line import/no-mutable-exports\r\n  var module = requireNativeModule<ExpoBeaconModule>(\"ExpoBeacon\");\r\n} catch {\r\n  throw new Error(\r\n    \"expo-beacon: native module not found. Make sure you are using a development build \" +\r\n      \"(not Expo Go) and have run `npx expo prebuild` followed by a native rebuild.\",\r\n  );\r\n}\r\n\r\nexport default module;\r\n"]}

package/build/index.d.ts

@@ -1,3 +1,3 @@
 export { default } from "./ExpoBeaconModule";
-export type { BeaconScanResult, PairedBeacon, BeaconRegionEvent, BeaconRangingEvent, ExpoBeaconModuleEvents, } from "./ExpoBeacon.types";
+export type { BeaconScanResult, PairedBeacon, BeaconRegionEvent, BeaconRangingEvent, BeaconDistanceEvent, ExpoBeaconModuleEvents, NotificationConfig, MonitoringOptions, BeaconNotificationConfig, ForegroundServiceConfig, NotificationChannelConfig, } 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,oBAAoB,CAAC;AAG7C,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG7C,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,uBAAuB,EACvB,yBAAyB,GAC1B,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,oBAAoB,CAAC","sourcesContent":["// Native module (default export)\r\nexport { default } from \"./ExpoBeaconModule\";\r\n\r\n// All public types\r\nexport type {\r\n  BeaconScanResult,\r\n  PairedBeacon,\r\n  BeaconRegionEvent,\r\n  BeaconRangingEvent,\r\n  ExpoBeaconModuleEvents,\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,oBAAoB,CAAC","sourcesContent":["// Native module (default export)\r\nexport { default } from \"./ExpoBeaconModule\";\r\n\r\n// All public types\r\nexport type {\r\n  BeaconScanResult,\r\n  PairedBeacon,\r\n  BeaconRegionEvent,\r\n  BeaconRangingEvent,\r\n  BeaconDistanceEvent,\r\n  ExpoBeaconModuleEvents,\r\n  NotificationConfig,\r\n  MonitoringOptions,\r\n  BeaconNotificationConfig,\r\n  ForegroundServiceConfig,\r\n  NotificationChannelConfig,\r\n} from \"./ExpoBeacon.types\";\r\n"]}

package/ios/ExpoBeaconModule.swift

@@ -5,8 +5,9 @@ import UserNotifications
 private let PAIRED_BEACONS_KEY = "expo.beacon.paired"
 private let IS_MONITORING_KEY = "expo.beacon.is_monitoring"
 private let MAX_DISTANCE_KEY = "expo.beacon.max_distance"
+private let NOTIFICATION_CONFIG_KEY = "expo.beacon.notification_config"
 
-public class ExpoBeaconModule: Module, CLLocationManagerDelegate {
+public class ExpoBeaconModule: NSObject, Module, CLLocationManagerDelegate {
 
     private lazy var locationManager: CLLocationManager = {
         let manager = CLLocationManager()
@@ -97,9 +98,29 @@ public class ExpoBeaconModule: Module, CLLocationManagerDelegate {
             return self.loadPairedBeaconsRaw()
         }
 
+        // MARK: - Notification Config
+
+        Function("setNotificationConfig") { (config: [String: Any]) in
+            if let data = try? JSONSerialization.data(withJSONObject: config),
+               let json = String(data: data, encoding: .utf8) {
+                UserDefaults.standard.set(json, forKey: NOTIFICATION_CONFIG_KEY)
+            }
+        }
+
         // MARK: - Monitoring
 
-        AsyncFunction("startMonitoring") { (maxDistance: Double?, promise: Promise) in
+        AsyncFunction("startMonitoring") { (options: Any?, promise: Promise) in
+            var maxDistance: Double? = nil
+            if let dist = options as? Double {
+                maxDistance = dist
+            } else if let map = options as? [String: Any] {
+                maxDistance = map["maxDistance"] as? Double
+                if let notifications = map["notifications"] as? [String: Any],
+                   let data = try? JSONSerialization.data(withJSONObject: notifications),
+                   let json = String(data: data, encoding: .utf8) {
+                    UserDefaults.standard.set(json, forKey: NOTIFICATION_CONFIG_KEY)
+                }
+            }
             if let dist = maxDistance {
                 UserDefaults.standard.set(dist, forKey: MAX_DISTANCE_KEY)
             } else {
@@ -274,10 +295,32 @@ public class ExpoBeaconModule: Module, CLLocationManagerDelegate {
     }
 
     private func postBeaconNotification(identifier: String, eventType: String) {
+        let cfg = loadNotificationConfig()
+        let eventsCfg = cfg["beaconEvents"] as? [String: Any]
+
+        // Respect the enabled flag (defaults to true)
+        if let enabled = eventsCfg?["enabled"] as? Bool, !enabled { return }
+
+        let defaultTitle = eventType == "enter" ? "Beacon Entered" : "Beacon Exited"
+        let title: String
+        if eventType == "enter" {
+            title = (eventsCfg?["enterTitle"] as? String).flatMap { $0.isEmpty ? nil : $0 } ?? defaultTitle
+        } else {
+            title = (eventsCfg?["exitTitle"] as? String).flatMap { $0.isEmpty ? nil : $0 } ?? defaultTitle
+        }
+
+        let bodyTemplate = (eventsCfg?["body"] as? String).flatMap { $0.isEmpty ? nil : $0 }
+            ?? "{identifier} region {event}ed"
+        let body = bodyTemplate
+            .replacingOccurrences(of: "{identifier}", with: identifier)
+            .replacingOccurrences(of: "{event}", with: eventType)
+
         let content = UNMutableNotificationContent()
-        content.title = eventType == "enter" ? "Beacon Entered" : "Beacon Exited"
-        content.body = "\(identifier) region \(eventType)ed"
-        content.sound = .default
+        content.title = title
+        content.body = body
+
+        let playSound = eventsCfg?["sound"] as? Bool ?? true
+        if playSound { content.sound = .default }
 
         let request = UNNotificationRequest(
             identifier: "beacon_\(eventType)_\(identifier)_\(Date().timeIntervalSince1970)",
@@ -287,6 +330,14 @@ public class ExpoBeaconModule: Module, CLLocationManagerDelegate {
         UNUserNotificationCenter.current().add(request, withCompletionHandler: nil)
     }
 
+    private func loadNotificationConfig() -> [String: Any] {
+        guard let json = UserDefaults.standard.string(forKey: NOTIFICATION_CONFIG_KEY),
+              let data = json.data(using: .utf8),
+              let dict = try? JSONSerialization.jsonObject(with: data) as? [String: Any]
+        else { return [:] }
+        return dict
+    }
+
     private func constraintMatches(_ a: CLBeaconIdentityConstraint, _ b: CLBeaconIdentityConstraint) -> Bool {
         return a.uuid == b.uuid && a.major == b.major && a.minor == b.minor
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-beacon",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "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

@@ -46,6 +46,69 @@ export type BeaconDistanceEvent = {
   distance: number;
 };
 
+/** Configuration for beacon enter/exit event notifications. */
+export type BeaconNotificationConfig = {
+  /** Whether to show enter/exit notifications. Default: true. */
+  enabled?: boolean;
+  /** Notification title on beacon enter. Default: "Beacon Entered". */
+  enterTitle?: string;
+  /** Notification title on beacon exit. Default: "Beacon Exited". */
+  exitTitle?: string;
+  /**
+   * Notification body template. Supports {identifier} and {event} placeholders.
+   * Default: "{identifier} region {event}ed".
+   */
+  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 foreground service notification (persistent status bar entry). */
+export type ForegroundServiceConfig = {
+  /** Title of the persistent notification. Default: "Beacon Monitoring Active". */
+  title?: string;
+  /** Body text of the persistent notification. Default: "Monitoring for iBeacons in the background". */
+  text?: string;
+  /** Android drawable resource name for the notification icon. */
+  icon?: string;
+};
+
+/** Configuration for the Android notification channel. */
+export type NotificationChannelConfig = {
+  /** Channel display name shown in system settings. Default: "Beacon Monitoring". */
+  name?: string;
+  /** Channel description shown in system settings. Default: "Used for background iBeacon region monitoring". */
+  description?: string;
+  /**
+   * Channel importance level. Default: 'low'.
+   * 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 the persistent foreground service notification (Android only). */
+  foregroundService?: ForegroundServiceConfig;
+  /** Settings for the Android notification channel (Android only). */
+  channel?: NotificationChannelConfig;
+};
+
+/** Options accepted by startMonitoring(). */
+export type MonitoringOptions = {
+  /**
+   * Maximum distance in metres for distance-based enter events.
+   * Exit events are always emitted when the region is lost.
+   */
+  maxDistance?: number;
+  /** Notification configuration overrides to apply for this monitoring session. */
+  notifications?: NotificationConfig;
+};
+
 /** Module event map. */
 export type ExpoBeaconModuleEvents = {
   onBeaconEnter: (params: BeaconRegionEvent) => void;

package/src/ExpoBeaconModule.ts

@@ -4,6 +4,8 @@ import {
   ExpoBeaconModuleEvents,
   BeaconScanResult,
   PairedBeacon,
+  NotificationConfig,
+  MonitoringOptions,
 } from "./ExpoBeacon.types";
 
 declare class ExpoBeaconModule extends NativeModule<ExpoBeaconModuleEvents> {
@@ -33,15 +35,21 @@ declare class ExpoBeaconModule extends NativeModule<ExpoBeaconModuleEvents> {
    */
   getPairedBeacons(): PairedBeacon[];
 
+  /**
+   * Set persistent notification configuration. Settings are saved and applied to all
+   * subsequent monitoring sessions until explicitly changed.
+   */
+  setNotificationConfig(config: NotificationConfig): void;
+
   /**
    * Start background region monitoring for all paired beacons.
    * On Android starts a foreground service.
    * On iOS starts CLLocationManager region monitoring.
-   * @param maxDistance Optional distance threshold in metres. Enter events are only
-   *   emitted when the beacon is measured to be within this distance.
-   *   Exit events are always emitted when the beacon region is lost.
+   *
+   * Accepts a plain number (backward-compatible maxDistance shorthand) or a
+   * MonitoringOptions object with maxDistance and/or notification overrides.
    */
-  startMonitoring(maxDistance?: number): Promise<void>;
+  startMonitoring(options?: MonitoringOptions | number): Promise<void>;
 
   /**
    * Stop background region monitoring.
@@ -61,4 +69,14 @@ declare class ExpoBeaconModule extends NativeModule<ExpoBeaconModuleEvents> {
   requestPermissionsAsync(): Promise<boolean>;
 }
 
-export default requireNativeModule<ExpoBeaconModule>("ExpoBeacon");
+try {
+  // eslint-disable-next-line import/no-mutable-exports
+  var module = requireNativeModule<ExpoBeaconModule>("ExpoBeacon");
+} catch {
+  throw new Error(
+    "expo-beacon: native module not found. Make sure you are using a development build " +
+      "(not Expo Go) and have run `npx expo prebuild` followed by a native rebuild.",
+  );
+}
+
+export default module;

package/src/index.ts

@@ -7,5 +7,11 @@ export type {
   PairedBeacon,
   BeaconRegionEvent,
   BeaconRangingEvent,
+  BeaconDistanceEvent,
   ExpoBeaconModuleEvents,
+  NotificationConfig,
+  MonitoringOptions,
+  BeaconNotificationConfig,
+  ForegroundServiceConfig,
+  NotificationChannelConfig,
 } from "./ExpoBeacon.types";