munim-bluetooth 0.3.23 → 0.3.25

package/ios/HybridMunimBluetooth.swift

@@ -10,6 +10,93 @@ import CoreBluetooth
 import NitroModules
 import React
 
+private let centralRestoreIdentifier = "com.munimbluetooth.central"
+private let peripheralRestoreIdentifier = "com.munimbluetooth.peripheral"
+
+private final class PeripheralManagerDelegateProxy: NSObject, CBPeripheralManagerDelegate {
+    weak var owner: HybridMunimBluetooth?
+    
+    init(owner: HybridMunimBluetooth) {
+        self.owner = owner
+    }
+    
+    func peripheralManagerDidUpdateState(_ peripheral: CBPeripheralManager) {
+        owner?.handlePeripheralManagerDidUpdateState(peripheral)
+    }
+    
+    func peripheralManagerDidStartAdvertising(_ peripheral: CBPeripheralManager, error: Error?) {
+        owner?.handlePeripheralManagerDidStartAdvertising(peripheral, error: error)
+    }
+    
+    func peripheralManager(_ peripheral: CBPeripheralManager, didAdd service: CBService, error: Error?) {
+        owner?.handlePeripheralManagerDidAddService(peripheral, service: service, error: error)
+    }
+
+    func peripheralManager(_ peripheral: CBPeripheralManager, willRestoreState dict: [String : Any]) {
+        owner?.handlePeripheralManagerWillRestoreState(peripheral, state: dict)
+    }
+}
+
+private final class CentralManagerDelegateProxy: NSObject, CBCentralManagerDelegate {
+    weak var owner: HybridMunimBluetooth?
+    
+    init(owner: HybridMunimBluetooth) {
+        self.owner = owner
+    }
+    
+    func centralManagerDidUpdateState(_ central: CBCentralManager) {
+        owner?.handleCentralManagerDidUpdateState(central)
+    }
+
+    func centralManager(_ central: CBCentralManager, willRestoreState dict: [String : Any]) {
+        owner?.handleCentralManagerWillRestoreState(central, state: dict)
+    }
+    
+    func centralManager(_ central: CBCentralManager, didDiscover peripheral: CBPeripheral, advertisementData: [String: Any], rssi RSSI: NSNumber) {
+        owner?.handleCentralManagerDidDiscover(central, peripheral: peripheral, advertisementData: advertisementData, rssi: RSSI)
+    }
+    
+    func centralManager(_ central: CBCentralManager, didConnect peripheral: CBPeripheral) {
+        owner?.handleCentralManagerDidConnect(central, peripheral: peripheral)
+    }
+    
+    func centralManager(_ central: CBCentralManager, didDisconnectPeripheral peripheral: CBPeripheral, error: Error?) {
+        owner?.handleCentralManagerDidDisconnectPeripheral(central, peripheral: peripheral, error: error)
+    }
+    
+    func centralManager(_ central: CBCentralManager, didFailToConnect peripheral: CBPeripheral, error: Error?) {
+        owner?.handleCentralManagerDidFailToConnect(central, peripheral: peripheral, error: error)
+    }
+}
+
+private final class PeripheralDelegateProxy: NSObject, CBPeripheralDelegate {
+    weak var owner: HybridMunimBluetooth?
+    
+    init(owner: HybridMunimBluetooth) {
+        self.owner = owner
+    }
+    
+    func peripheral(_ peripheral: CBPeripheral, didDiscoverServices error: Error?) {
+        owner?.handlePeripheralDidDiscoverServices(peripheral, error: error)
+    }
+    
+    func peripheral(_ peripheral: CBPeripheral, didDiscoverCharacteristicsFor service: CBService, error: Error?) {
+        owner?.handlePeripheralDidDiscoverCharacteristics(peripheral, service: service, error: error)
+    }
+    
+    func peripheral(_ peripheral: CBPeripheral, didUpdateValueFor characteristic: CBCharacteristic, error: Error?) {
+        owner?.handlePeripheralDidUpdateValue(peripheral, characteristic: characteristic, error: error)
+    }
+    
+    func peripheral(_ peripheral: CBPeripheral, didWriteValueFor characteristic: CBCharacteristic, error: Error?) {
+        owner?.handlePeripheralDidWriteValue(peripheral, characteristic: characteristic, error: error)
+    }
+    
+    func peripheral(_ peripheral: CBPeripheral, didReadRSSI RSSI: NSNumber, error: Error?) {
+        owner?.handlePeripheralDidReadRSSI(peripheral, rssi: RSSI, error: error)
+    }
+}
+
 class HybridMunimBluetooth: HybridMunimBluetoothSpec {
     // Peripheral Manager
     private var peripheralManager: CBPeripheralManager?
@@ -21,13 +108,34 @@ class HybridMunimBluetooth: HybridMunimBluetoothSpec {
     private var discoveredPeripherals: [String: CBPeripheral] = [:]
     private var connectedPeripherals: [String: CBPeripheral] = [:]
     private var peripheralCharacteristics: [String: [CBCharacteristic]] = [:]
+    private var pendingConnectionPromises: [String: Promise<Void>] = [:]
+    private var pendingServiceDiscoveryPromises: [String: Promise<[GATTService]>] = [:]
+    private var pendingCharacteristicDiscoveryCounts: [String: Int] = [:]
+    private var pendingReadPromises: [String: Promise<CharacteristicValue>] = [:]
+    private var pendingRSSIPromises: [String: Promise<Double>] = [:]
     private var scanOptions: ScanOptions?
     private var isScanning = false
+    private var isBackgroundSessionActive = false
+    private lazy var peripheralManagerDelegateProxy = PeripheralManagerDelegateProxy(owner: self)
+    private lazy var centralManagerDelegateProxy = CentralManagerDelegateProxy(owner: self)
+    private lazy var peripheralDelegateProxy = PeripheralDelegateProxy(owner: self)
     
     override init() {
         super.init()
-        peripheralManager = CBPeripheralManager(delegate: self, queue: nil)
-        centralManager = CBCentralManager(delegate: self, queue: nil)
+        peripheralManager = CBPeripheralManager(
+            delegate: peripheralManagerDelegateProxy,
+            queue: nil,
+            options: [
+                CBPeripheralManagerOptionRestoreIdentifierKey: peripheralRestoreIdentifier
+            ]
+        )
+        centralManager = CBCentralManager(
+            delegate: centralManagerDelegateProxy,
+            queue: nil,
+            options: [
+                CBCentralManagerOptionRestoreIdentifierKey: centralRestoreIdentifier
+            ]
+        )
     }
     
     // MARK: - Event Emission
@@ -287,8 +395,12 @@ class HybridMunimBluetooth: HybridMunimBluetoothSpec {
         if let options = options {
             scanOptions[CBCentralManagerScanOptionAllowDuplicatesKey] = options.allowDuplicates ?? false
         }
-        
-        centralManager.scanForPeripherals(withServices: nil, options: scanOptions as [String : Any])
+
+        let serviceUUIDs = options?.serviceUUIDs?.map { CBUUID(string: $0) }
+        centralManager.scanForPeripherals(
+            withServices: serviceUUIDs?.isEmpty == false ? serviceUUIDs : nil,
+            options: scanOptions as [String : Any]
+        )
     }
     
     func stopScan() throws {
@@ -298,14 +410,19 @@ class HybridMunimBluetooth: HybridMunimBluetoothSpec {
     
     func connect(deviceId: String) throws -> Promise<Void> {
         let promise = Promise<Void>()
+        if connectedPeripherals[deviceId] != nil {
+            promise.resolve(withResult: ())
+            return promise
+        }
+
         guard let peripheral = self.discoveredPeripherals[deviceId] else {
             promise.reject(withError: NSError(domain: "MunimBluetooth", code: 1, userInfo: [NSLocalizedDescriptionKey: "Device not found"]))
             return promise
         }
-        
+
+        pendingConnectionPromises[deviceId] = promise
+        peripheral.delegate = peripheralDelegateProxy
         self.centralManager?.connect(peripheral, options: nil)
-        self.connectedPeripherals[deviceId] = peripheral
-        promise.resolve(withResult: ())
         return promise
     }
     
@@ -313,6 +430,7 @@ class HybridMunimBluetooth: HybridMunimBluetoothSpec {
         guard let peripheral = connectedPeripherals[deviceId] else { return }
         centralManager?.cancelPeripheralConnection(peripheral)
         connectedPeripherals.removeValue(forKey: deviceId)
+        rejectPendingOperations(for: deviceId, error: NSError(domain: "MunimBluetooth", code: 1, userInfo: [NSLocalizedDescriptionKey: "Disconnected from \(deviceId)"]))
     }
     
     func discoverServices(deviceId: String) throws -> Promise<[GATTService]> {
@@ -321,15 +439,37 @@ class HybridMunimBluetooth: HybridMunimBluetoothSpec {
             promise.reject(withError: NSError(domain: "MunimBluetooth", code: 1, userInfo: [NSLocalizedDescriptionKey: "Device not connected"]))
             return promise
         }
-        
+
+        if let services = peripheral.services,
+           services.allSatisfy({ $0.characteristics != nil }) {
+            promise.resolve(withResult: buildGATTServices(from: services))
+            return promise
+        }
+
+        pendingServiceDiscoveryPromises[deviceId] = promise
         peripheral.discoverServices(nil)
-        promise.resolve(withResult: [])
         return promise
     }
     
     func readCharacteristic(deviceId: String, serviceUUID: String, characteristicUUID: String) throws -> Promise<CharacteristicValue> {
         let promise = Promise<CharacteristicValue>()
-        promise.reject(withError: NSError(domain: "MunimBluetooth", code: 1, userInfo: [NSLocalizedDescriptionKey: "Not implemented"]))
+
+        guard let peripheral = connectedPeripherals[deviceId] else {
+            promise.reject(withError: NSError(domain: "MunimBluetooth", code: 1, userInfo: [NSLocalizedDescriptionKey: "Device not connected"]))
+            return promise
+        }
+
+        guard let characteristic = findCharacteristic(
+            deviceId: deviceId,
+            serviceUUID: serviceUUID,
+            characteristicUUID: characteristicUUID
+        ) else {
+            promise.reject(withError: NSError(domain: "MunimBluetooth", code: 1, userInfo: [NSLocalizedDescriptionKey: "Characteristic not found"]))
+            return promise
+        }
+
+        pendingReadPromises[characteristicKey(deviceId: deviceId, serviceUUID: serviceUUID, characteristicUUID: characteristicUUID)] = promise
+        peripheral.readValue(for: characteristic)
         return promise
     }
     
@@ -359,11 +499,37 @@ class HybridMunimBluetooth: HybridMunimBluetoothSpec {
             promise.reject(withError: NSError(domain: "MunimBluetooth", code: 1, userInfo: [NSLocalizedDescriptionKey: "Device not connected"]))
             return promise
         }
-        
+
+        pendingRSSIPromises[deviceId] = promise
         peripheral.readRSSI()
-        promise.resolve(withResult: 0)
         return promise
     }
+
+    func startBackgroundSession(options: BackgroundSessionOptions) throws {
+        isBackgroundSessionActive = true
+
+        let advertisingOptions = AdvertisingOptions(
+            serviceUUIDs: options.serviceUUIDs,
+            localName: options.localName,
+            manufacturerData: nil,
+            advertisingData: nil
+        )
+
+        try startAdvertising(options: advertisingOptions)
+        try startScan(
+            options: ScanOptions(
+                serviceUUIDs: options.serviceUUIDs,
+                allowDuplicates: options.allowDuplicates,
+                scanMode: options.scanMode
+            )
+        )
+    }
+
+    func stopBackgroundSession() throws {
+        isBackgroundSessionActive = false
+        try stopScan()
+        try stopAdvertising()
+    }
     
     func addListener(eventName: String) throws {
         // Event management
@@ -406,15 +572,86 @@ class HybridMunimBluetooth: HybridMunimBluetoothSpec {
             advertisingData[CBAdvertisementDataTxPowerLevelKey] = txPowerLevel
         }
     }
-}
 
-// MARK: - CBPeripheralManagerDelegate Implementation
-extension HybridMunimBluetooth: CBPeripheralManagerDelegate {
-    func peripheralManagerDidUpdateState(_ peripheral: CBPeripheralManager) {
+    private func characteristicKey(deviceId: String, serviceUUID: String, characteristicUUID: String) -> String {
+        "\(deviceId.lowercased())|\(serviceUUID.lowercased())|\(characteristicUUID.lowercased())"
+    }
+
+    private func buildGATTServices(from services: [CBService]) -> [GATTService] {
+        services.map { service in
+            GATTService(
+                uuid: service.uuid.uuidString,
+                characteristics: (service.characteristics ?? []).map { characteristic in
+                    GATTCharacteristic(
+                        uuid: characteristic.uuid.uuidString,
+                        properties: mapProperties(characteristic.properties),
+                        value: characteristic.value?.map { String(format: "%02x", $0) }.joined()
+                    )
+                }
+            )
+        }
+    }
+
+    private func mapProperties(_ properties: CBCharacteristicProperties) -> [String] {
+        var result: [String] = []
+        if properties.contains(.read) {
+            result.append("read")
+        }
+        if properties.contains(.write) {
+            result.append("write")
+        }
+        if properties.contains(.writeWithoutResponse) {
+            result.append("writeWithoutResponse")
+        }
+        if properties.contains(.notify) {
+            result.append("notify")
+        }
+        if properties.contains(.indicate) {
+            result.append("indicate")
+        }
+        return result
+    }
+
+    private func findCharacteristic(deviceId: String, serviceUUID: String, characteristicUUID: String) -> CBCharacteristic? {
+        guard let peripheral = connectedPeripherals[deviceId],
+              let services = peripheral.services else {
+            return nil
+        }
+
+        let matchingService = services.first {
+            $0.uuid.uuidString.caseInsensitiveCompare(serviceUUID) == .orderedSame
+        }
+        let matchingCharacteristic = matchingService?.characteristics?.first {
+            $0.uuid.uuidString.caseInsensitiveCompare(characteristicUUID) == .orderedSame
+        }
+        return matchingCharacteristic
+    }
+
+    private func rejectPendingOperations(for deviceId: String, error: Error) {
+        pendingConnectionPromises.removeValue(forKey: deviceId)?.reject(withError: error)
+        pendingServiceDiscoveryPromises.removeValue(forKey: deviceId)?.reject(withError: error)
+        pendingCharacteristicDiscoveryCounts.removeValue(forKey: deviceId)
+        pendingRSSIPromises.removeValue(forKey: deviceId)?.reject(withError: error)
+
+        let prefix = "\(deviceId.lowercased())|"
+        for key in pendingReadPromises.keys where key.hasPrefix(prefix) {
+            pendingReadPromises.removeValue(forKey: key)?.reject(withError: error)
+        }
+    }
+
+    // MARK: - CoreBluetooth Delegate Forwarding
+    
+    func handlePeripheralManagerDidUpdateState(_ peripheral: CBPeripheralManager) {
         // Handle state updates
     }
+
+    func handlePeripheralManagerWillRestoreState(_ peripheral: CBPeripheralManager, state: [String: Any]) {
+        if peripheral.isAdvertising {
+            isBackgroundSessionActive = true
+        }
+    }
     
-    func peripheralManagerDidStartAdvertising(_ peripheral: CBPeripheralManager, error: Error?) {
+    func handlePeripheralManagerDidStartAdvertising(_ peripheral: CBPeripheralManager, error: Error?) {
         if let error = error {
             NSLog("Bluetooth event")
         } else {
@@ -422,23 +659,32 @@ extension HybridMunimBluetooth: CBPeripheralManagerDelegate {
         }
     }
     
-    func peripheralManager(_ peripheral: CBPeripheralManager, didAdd service: CBService, error: Error?) {
+    func handlePeripheralManagerDidAddService(_ peripheral: CBPeripheralManager, service: CBService, error: Error?) {
         if let error = error {
             NSLog("Bluetooth event")
         } else {
             NSLog("Bluetooth event")
         }
     }
-}
-
-// MARK: - CBCentralManagerDelegate Implementation
-extension HybridMunimBluetooth: CBCentralManagerDelegate {
-    func centralManagerDidUpdateState(_ central: CBCentralManager) {
+    
+    func handleCentralManagerDidUpdateState(_ central: CBCentralManager) {
         let state = central.state
         NSLog("Bluetooth event")
     }
+
+    func handleCentralManagerWillRestoreState(_ central: CBCentralManager, state: [String: Any]) {
+        if let scanServices = state[CBCentralManagerRestoredStateScanServicesKey] as? [CBUUID] {
+            scanOptions = ScanOptions(
+                serviceUUIDs: scanServices.map { $0.uuidString },
+                allowDuplicates: nil,
+                scanMode: nil
+            )
+            isScanning = true
+            isBackgroundSessionActive = true
+        }
+    }
     
-    func centralManager(_ central: CBCentralManager, didDiscover peripheral: CBPeripheral, advertisementData: [String: Any], rssi RSSI: NSNumber) {
+    func handleCentralManagerDidDiscover(_ central: CBCentralManager, peripheral: CBPeripheral, advertisementData: [String: Any], rssi RSSI: NSNumber) {
         let deviceId = peripheral.identifier.uuidString
         discoveredPeripherals[deviceId] = peripheral
         
@@ -448,35 +694,58 @@ extension HybridMunimBluetooth: CBCentralManagerDelegate {
         NSLog("Bluetooth: deviceFound - %@", deviceId)
     }
     
-    func centralManager(_ central: CBCentralManager, didConnect peripheral: CBPeripheral) {
+    func handleCentralManagerDidConnect(_ central: CBCentralManager, peripheral: CBPeripheral) {
         let deviceId = peripheral.identifier.uuidString
         connectedPeripherals[deviceId] = peripheral
-        peripheral.delegate = self
+        peripheral.delegate = peripheralDelegateProxy
+        pendingConnectionPromises.removeValue(forKey: deviceId)?.resolve(withResult: ())
         
         NSLog("Bluetooth event")
     }
     
-    func centralManager(_ central: CBCentralManager, didDisconnectPeripheral peripheral: CBPeripheral, error: Error?) {
+    func handleCentralManagerDidDisconnectPeripheral(_ central: CBCentralManager, peripheral: CBPeripheral, error: Error?) {
         let deviceId = peripheral.identifier.uuidString
         connectedPeripherals.removeValue(forKey: deviceId)
         peripheralCharacteristics.removeValue(forKey: deviceId)
+        rejectPendingOperations(
+            for: deviceId,
+            error: error ?? NSError(domain: "MunimBluetooth", code: 1, userInfo: [NSLocalizedDescriptionKey: "Disconnected from \(deviceId)"])
+        )
         
         NSLog("Bluetooth event")
     }
     
-    func centralManager(_ central: CBCentralManager, didFailToConnect peripheral: CBPeripheral, error: Error?) {
+    func handleCentralManagerDidFailToConnect(_ central: CBCentralManager, peripheral: CBPeripheral, error: Error?) {
         let deviceId = peripheral.identifier.uuidString
+        rejectPendingOperations(
+            for: deviceId,
+            error: error ?? NSError(domain: "MunimBluetooth", code: 1, userInfo: [NSLocalizedDescriptionKey: "Failed to connect to \(deviceId)"])
+        )
         NSLog("Bluetooth: connectionFailed")
     }
-}
-
-// MARK: - CBPeripheralDelegate Implementation
-extension HybridMunimBluetooth: CBPeripheralDelegate {
-    func peripheral(_ peripheral: CBPeripheral, didDiscoverServices error: Error?) {
+    
+    func handlePeripheralDidDiscoverServices(_ peripheral: CBPeripheral, error: Error?) {
         let deviceId = peripheral.identifier.uuidString
-        
-        guard let services = peripheral.services else { return }
-        
+
+        if let error = error {
+            pendingServiceDiscoveryPromises.removeValue(forKey: deviceId)?.reject(withError: error)
+            pendingCharacteristicDiscoveryCounts.removeValue(forKey: deviceId)
+            return
+        }
+
+        guard let services = peripheral.services else {
+            pendingServiceDiscoveryPromises.removeValue(forKey: deviceId)?.resolve(withResult: [])
+            pendingCharacteristicDiscoveryCounts.removeValue(forKey: deviceId)
+            return
+        }
+
+        if services.isEmpty {
+            pendingServiceDiscoveryPromises.removeValue(forKey: deviceId)?.resolve(withResult: [])
+            pendingCharacteristicDiscoveryCounts.removeValue(forKey: deviceId)
+            return
+        }
+
+        pendingCharacteristicDiscoveryCounts[deviceId] = services.count
         for service in services {
             peripheral.discoverCharacteristics(nil, for: service)
         }
@@ -484,30 +753,72 @@ extension HybridMunimBluetooth: CBPeripheralDelegate {
         NSLog("Bluetooth event")
     }
     
-    func peripheral(_ peripheral: CBPeripheral, didDiscoverCharacteristicsFor service: CBService, error: Error?) {
+    func handlePeripheralDidDiscoverCharacteristics(_ peripheral: CBPeripheral, service: CBService, error: Error?) {
         let deviceId = peripheral.identifier.uuidString
-        
+
+        if let error = error {
+            pendingServiceDiscoveryPromises.removeValue(forKey: deviceId)?.reject(withError: error)
+            pendingCharacteristicDiscoveryCounts.removeValue(forKey: deviceId)
+            return
+        }
+
         guard let characteristics = service.characteristics else { return }
-        
+
         if peripheralCharacteristics[deviceId] == nil {
             peripheralCharacteristics[deviceId] = []
         }
         peripheralCharacteristics[deviceId]?.append(contentsOf: characteristics)
+
+        if let remaining = pendingCharacteristicDiscoveryCounts[deviceId] {
+            let nextRemaining = max(remaining - 1, 0)
+            if nextRemaining == 0 {
+                pendingCharacteristicDiscoveryCounts.removeValue(forKey: deviceId)
+                pendingServiceDiscoveryPromises.removeValue(forKey: deviceId)?.resolve(
+                    withResult: buildGATTServices(from: peripheral.services ?? [])
+                )
+            } else {
+                pendingCharacteristicDiscoveryCounts[deviceId] = nextRemaining
+            }
+        }
         
         NSLog("Bluetooth event")
     }
     
-    func peripheral(_ peripheral: CBPeripheral, didUpdateValueFor characteristic: CBCharacteristic, error: Error?) {
+    func handlePeripheralDidUpdateValue(_ peripheral: CBPeripheral, characteristic: CBCharacteristic, error: Error?) {
         let deviceId = peripheral.identifier.uuidString
-        
+
+        if let error = error {
+            pendingReadPromises.removeValue(
+                forKey: characteristicKey(
+                    deviceId: deviceId,
+                    serviceUUID: characteristic.service.uuid.uuidString,
+                    characteristicUUID: characteristic.uuid.uuidString
+                )
+            )?.reject(withError: error)
+            return
+        }
+
         guard let data = characteristic.value else { return }
-        
+
         let hexString = data.map { String(format: "%02x", $0) }.joined()
+        pendingReadPromises.removeValue(
+            forKey: characteristicKey(
+                deviceId: deviceId,
+                serviceUUID: characteristic.service.uuid.uuidString,
+                characteristicUUID: characteristic.uuid.uuidString
+            )
+        )?.resolve(
+            withResult: CharacteristicValue(
+                value: hexString,
+                serviceUUID: characteristic.service.uuid.uuidString,
+                characteristicUUID: characteristic.uuid.uuidString
+            )
+        )
         
         NSLog("Bluetooth: characteristicValueChanged")
     }
     
-    func peripheral(_ peripheral: CBPeripheral, didWriteValueFor characteristic: CBCharacteristic, error: Error?) {
+    func handlePeripheralDidWriteValue(_ peripheral: CBPeripheral, characteristic: CBCharacteristic, error: Error?) {
         let deviceId = peripheral.identifier.uuidString
         
         if let error = error {
@@ -517,13 +828,16 @@ extension HybridMunimBluetooth: CBPeripheralDelegate {
         }
     }
     
-    func peripheral(_ peripheral: CBPeripheral, didReadRSSI RSSI: NSNumber, error: Error?) {
+    func handlePeripheralDidReadRSSI(_ peripheral: CBPeripheral, rssi RSSI: NSNumber, error: Error?) {
         let deviceId = peripheral.identifier.uuidString
-        
+
         if let error = error {
+            pendingRSSIPromises.removeValue(forKey: deviceId)?.reject(withError: error)
             NSLog("Bluetooth event")
-        } else {
-            NSLog("Bluetooth event")
+            return
         }
+
+        pendingRSSIPromises.removeValue(forKey: deviceId)?.resolve(withResult: RSSI.doubleValue)
+        NSLog("Bluetooth event")
     }
 }

package/lib/commonjs/index.js

@@ -19,8 +19,10 @@ exports.removeListeners = removeListeners;
 exports.requestBluetoothPermission = requestBluetoothPermission;
 exports.setServices = setServices;
 exports.startAdvertising = startAdvertising;
+exports.startBackgroundSession = startBackgroundSession;
 exports.startScan = startScan;
 exports.stopAdvertising = stopAdvertising;
+exports.stopBackgroundSession = stopBackgroundSession;
 exports.stopScan = stopScan;
 exports.subscribeToCharacteristic = subscribeToCharacteristic;
 exports.unsubscribeFromCharacteristic = unsubscribeFromCharacteristic;
@@ -228,6 +230,23 @@ function readRSSI(deviceId) {
   return MunimBluetooth.readRSSI(deviceId);
 }
 
+/**
+ * Start a best-effort background BLE session.
+ *
+ * Android uses a foreground service. iOS relies on the host app's Bluetooth
+ * background modes and state restoration.
+ */
+function startBackgroundSession(options) {
+  return MunimBluetooth.startBackgroundSession(options);
+}
+
+/**
+ * Stop the active background BLE session.
+ */
+function stopBackgroundSession() {
+  return MunimBluetooth.stopBackgroundSession();
+}
+
 // ========== Event Management ==========
 
 /**
@@ -302,6 +321,8 @@ var _default = exports.default = {
   unsubscribeFromCharacteristic,
   getConnectedDevices,
   readRSSI,
+  startBackgroundSession,
+  stopBackgroundSession,
   // Events
   addDeviceFoundListener,
   addEventListener,

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNativeNitroModules","require","_reactNative","MunimBluetooth","NitroModules","createHybridObject","nativeEventModule","Platform","OS","NativeModules","MunimBluetoothEventEmitter","console","log","Object","keys","filter","key","includes","eventEmitter","DeviceEventEmitter","NativeEventEmitter","error","warn","startAdvertising","options","updateAdvertisingData","advertisingData","getAdvertisingData","stopAdvertising","setServices","services","isBluetoothEnabled","requestBluetoothPermission","startScan","stopScan","connect","deviceId","disconnect","discoverServices","readCharacteristic","serviceUUID","characteristicUUID","writeCharacteristic","value","writeType","subscribeToCharacteristic","unsubscribeFromCharacteristic","getConnectedDevices","readRSSI","addDeviceFoundListener","callback","subscription","addListener","remove","addEventListener","eventName","removeListeners","count","_default","exports","default"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_reactNativeNitroModules","require","_reactNative","MunimBluetooth","NitroModules","createHybridObject","nativeEventModule","Platform","OS","NativeModules","MunimBluetoothEventEmitter","console","log","Object","keys","filter","key","includes","eventEmitter","DeviceEventEmitter","NativeEventEmitter","error","warn","startAdvertising","options","updateAdvertisingData","advertisingData","getAdvertisingData","stopAdvertising","setServices","services","isBluetoothEnabled","requestBluetoothPermission","startScan","stopScan","connect","deviceId","disconnect","discoverServices","readCharacteristic","serviceUUID","characteristicUUID","writeCharacteristic","value","writeType","subscribeToCharacteristic","unsubscribeFromCharacteristic","getConnectedDevices","readRSSI","startBackgroundSession","stopBackgroundSession","addDeviceFoundListener","callback","subscription","addListener","remove","addEventListener","eventName","removeListeners","count","_default","exports","default"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/index.js

@@ -202,6 +202,23 @@ export function readRSSI(deviceId) {
   return MunimBluetooth.readRSSI(deviceId);
 }
 
+/**
+ * Start a best-effort background BLE session.
+ *
+ * Android uses a foreground service. iOS relies on the host app's Bluetooth
+ * background modes and state restoration.
+ */
+export function startBackgroundSession(options) {
+  return MunimBluetooth.startBackgroundSession(options);
+}
+
+/**
+ * Stop the active background BLE session.
+ */
+export function stopBackgroundSession() {
+  return MunimBluetooth.stopBackgroundSession();
+}
+
 // ========== Event Management ==========
 
 /**
@@ -277,6 +294,8 @@ export default {
   unsubscribeFromCharacteristic,
   getConnectedDevices,
   readRSSI,
+  startBackgroundSession,
+  stopBackgroundSession,
   // Events
   addDeviceFoundListener,
   addEventListener,