@capacitor-community/bluetooth-le 3.0.0 → 3.0.2

package/README.md

@@ -13,7 +13,7 @@
   <a href="https://www.npmjs.com/package/@capacitor-community/bluetooth-le"><img src="https://img.shields.io/npm/dw/@capacitor-community/bluetooth-le?style=flat-square" /></a>
   <a href="https://www.npmjs.com/package/@capacitor-community/bluetooth-le"><img src="https://img.shields.io/npm/v/@capacitor-community/bluetooth-le?style=flat-square" /></a>
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-<a href="#contributors-"><img src="https://img.shields.io/badge/all%20contributors-10-orange?style=flat-square" /></a>
+<a href="#contributors-"><img src="https://img.shields.io/badge/all%20contributors-14-orange?style=flat-square" /></a>
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 </p>
 
@@ -122,6 +122,8 @@ If the app needs to use Bluetooth while it is in the background, you also have t
 
 ```
 
+**Note**: Bluetooth is **not** available in the iOS simulator. The `initialize` call will be rejected with an error "BLE unsupported". You have to test your app on a real device.
+
 ### Android
 
 On Android, no further steps are required to use the plugin (if you are using Capacitor 2, see [here](https://github.com/capacitor-community/bluetooth-le/blob/0.x/README.md#android)).
@@ -205,6 +207,8 @@ import { BleClient } from '@capacitor-community/bluetooth-le';
 import { BluetoothLe } from '@capacitor-community/bluetooth-le';
 ```
 
+### Heart rate monitor
+
 Here is an example of how to use the plugin. It shows how to read the heart rate from a BLE heart rate monitor such as the Polar H10.
 
 ```typescript
@@ -277,7 +281,9 @@ function parseHeartRate(value: DataView): number {
 }
 ```
 
-An example of using the scanning API:
+### Scanning API
+
+Here is an example of using the scanning API.
 
 ```typescript
 import { BleClient, numberToUUID } from '@capacitor-community/bluetooth-le';
@@ -401,6 +407,7 @@ enable() => Promise<void>
 
 Enable Bluetooth.
 Only available on **Android**.
+_deprecated_ See https://developer.android.com/reference/android/bluetooth/BluetoothAdapter#enable()
 
 ---
 
@@ -412,6 +419,7 @@ disable() => Promise<void>
 
 Disable Bluetooth.
 Only available on **Android**.
+_deprecated_ See https://developer.android.com/reference/android/bluetooth/BluetoothAdapter#disable()
 
 ---
 
@@ -528,7 +536,7 @@ requestLEScan(options: RequestBleDeviceOptions, callback: (result: ScanResult) =
 
 Start scanning for BLE devices to interact with according to the filters in the options. The callback will be invoked on each device that is found.
 Scanning will continue until `stopLEScan` is called. For an example, see [usage](#usage).
-**NOTE**: Use with care on **web** platform, the required API is still behind a flag in most browsers.
+**Note**: Use with care on **web** platform, the required API is still behind a flag in most browsers.
 
 | Param          | Type                                                                        |
 | -------------- | --------------------------------------------------------------------------- |
@@ -604,15 +612,16 @@ Connect to a peripheral BLE device. For an example, see [usage](#usage).
 ### createBond(...)
 
 ```typescript
-createBond(deviceId: string) => Promise<void>
+createBond(deviceId: string, options?: TimeoutOptions | undefined) => Promise<void>
 ```
 
 Create a bond with a peripheral BLE device.
 Only available on **Android**. On iOS bonding is handled by the OS.
 
-| Param          | Type                | Description                                                                                                    |
-| -------------- | ------------------- | -------------------------------------------------------------------------------------------------------------- |
-| **`deviceId`** | <code>string</code> | The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan)) |
+| Param          | Type                                                      | Description                                                                                                    |
+| -------------- | --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| **`deviceId`** | <code>string</code>                                       | The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan)) |
+| **`options`**  | <code><a href="#timeoutoptions">TimeoutOptions</a></code> | Options for plugin call                                                                                        |
 
 ---
 
@@ -1042,6 +1051,23 @@ await BleClient.disconnect(device.deviceId);
 await BleClient.connect(device.deviceId);
 ```
 
+#### No devices found on Android
+
+On Android, the `initialize` call requests the location permission. However, if location services are disable on the OS level, the app will not find any devices. You can check if the location is enabled and open the settings when not.
+
+```typescript
+async function initialize() {
+  // Check if location is enabled
+  if (this.platform.is('android')) {
+    const isLocationEnabled = await BleClient.isLocationEnabled();
+    if (!isLocationEnabled) {
+      await BleClient.openLocationSettings();
+    }
+  }
+  await BleClient.initialize();
+}
+```
+
 ## Contributors ✨
 
 Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
@@ -1064,6 +1090,10 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/jrobeson"><img src="https://avatars.githubusercontent.com/u/56908?v=4?s=100" width="100px;" alt="Johnny Robeson"/><br /><sub><b>Johnny Robeson</b></sub></a><br /><a href="https://github.com/capacitor-community/bluetooth-le/commits?author=jrobeson" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/aadito123"><img src="https://avatars.githubusercontent.com/u/63646058?v=4?s=100" width="100px;" alt="Aadit Olkar"/><br /><sub><b>Aadit Olkar</b></sub></a><br /><a href="https://github.com/capacitor-community/bluetooth-le/commits?author=aadito123" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/y3nd"><img src="https://avatars.githubusercontent.com/u/18102153?v=4?s=100" width="100px;" alt="Yoann N."/><br /><sub><b>Yoann N.</b></sub></a><br /><a href="https://github.com/capacitor-community/bluetooth-le/commits?author=y3nd" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/Andy3189"><img src="https://avatars.githubusercontent.com/u/2084016?v=4?s=100" width="100px;" alt="Andy3189"/><br /><sub><b>Andy3189</b></sub></a><br /><a href="https://github.com/capacitor-community/bluetooth-le/commits?author=Andy3189" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/RFM69CW"><img src="https://avatars.githubusercontent.com/u/20404734?v=4?s=100" width="100px;" alt="Sammy"/><br /><sub><b>Sammy</b></sub></a><br /><a href="https://github.com/capacitor-community/bluetooth-le/commits?author=RFM69CW" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/td-tomasz-joniec"><img src="https://avatars.githubusercontent.com/u/109506928?v=4?s=100" width="100px;" alt="td-tomasz-joniec"/><br /><sub><b>td-tomasz-joniec</b></sub></a><br /><a href="https://github.com/capacitor-community/bluetooth-le/commits?author=td-tomasz-joniec" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://fanxj.com"><img src="https://avatars.githubusercontent.com/u/10436013?v=4?s=100" width="100px;" alt="Michele Ferrari"/><br /><sub><b>Michele Ferrari</b></sub></a><br /><a href="https://github.com/capacitor-community/bluetooth-le/commits?author=micheleypf" title="Code">💻</a></td>
     </tr>
   </tbody>
 </table>

package/android/src/main/java/com/capacitorjs/community/plugins/bluetoothle/BluetoothLe.kt

@@ -1,7 +1,13 @@
 package com.capacitorjs.community.plugins.bluetoothle
 
 import android.Manifest
-import android.bluetooth.*
+import android.annotation.SuppressLint
+import android.bluetooth.BluetoothAdapter
+import android.bluetooth.BluetoothDevice
+import android.bluetooth.BluetoothGatt
+import android.bluetooth.BluetoothGattCharacteristic
+import android.bluetooth.BluetoothManager
+import android.bluetooth.BluetoothProfile
 import android.bluetooth.le.ScanFilter
 import android.bluetooth.le.ScanResult
 import android.bluetooth.le.ScanSettings
@@ -14,15 +20,24 @@ import android.location.LocationManager
 import android.net.Uri
 import android.os.Build
 import android.os.ParcelUuid
-import android.provider.Settings.*
+import android.provider.Settings.ACTION_APPLICATION_DETAILS_SETTINGS
+import android.provider.Settings.ACTION_BLUETOOTH_SETTINGS
+import android.provider.Settings.ACTION_LOCATION_SOURCE_SETTINGS
 import androidx.core.location.LocationManagerCompat
-import com.getcapacitor.*
+import com.getcapacitor.JSArray
+import com.getcapacitor.JSObject
+import com.getcapacitor.Logger
+import com.getcapacitor.PermissionState
+import com.getcapacitor.Plugin
+import com.getcapacitor.PluginCall
+import com.getcapacitor.PluginMethod
 import com.getcapacitor.annotation.CapacitorPlugin
 import com.getcapacitor.annotation.Permission
 import com.getcapacitor.annotation.PermissionCallback
-import java.util.*
+import java.util.UUID
 
 
+@SuppressLint("MissingPermission")
 @CapacitorPlugin(
     name = "BluetoothLe",
     permissions = [
@@ -83,8 +98,7 @@ class BluetoothLe : Plugin() {
 
     @PluginMethod
     fun initialize(call: PluginCall) {
-        // Build.VERSION_CODES.S = 31
-        if (Build.VERSION.SDK_INT >= 31) {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
             val neverForLocation = call.getBoolean("androidNeverForLocation", false) as Boolean
             aliases = if (neverForLocation) {
                 arrayOf(
@@ -426,7 +440,8 @@ class BluetoothLe : Plugin() {
     @PluginMethod
     fun createBond(call: PluginCall) {
         val device = getOrCreateDevice(call) ?: return
-        device.createBond { response ->
+        val timeout = call.getFloat("timeout", DEFAULT_TIMEOUT)!!.toLong()
+        device.createBond(timeout) { response ->
             run {
                 if (response.success) {
                     call.resolve()

package/android/src/main/java/com/capacitorjs/community/plugins/bluetoothle/Device.kt

@@ -1,6 +1,16 @@
 package com.capacitorjs.community.plugins.bluetoothle
 
-import android.bluetooth.*
+import android.annotation.SuppressLint
+import android.annotation.TargetApi
+import android.bluetooth.BluetoothAdapter
+import android.bluetooth.BluetoothDevice
+import android.bluetooth.BluetoothGatt
+import android.bluetooth.BluetoothGattCallback
+import android.bluetooth.BluetoothGattCharacteristic
+import android.bluetooth.BluetoothGattDescriptor
+import android.bluetooth.BluetoothGattService
+import android.bluetooth.BluetoothProfile
+import android.bluetooth.BluetoothStatusCodes
 import android.content.BroadcastReceiver
 import android.content.Context
 import android.content.Intent
@@ -8,14 +18,36 @@ import android.content.IntentFilter
 import android.os.Build
 import android.os.Handler
 import android.os.Looper
+import androidx.annotation.RequiresApi
 import com.getcapacitor.Logger
-import java.util.*
+import java.util.UUID
+import java.util.concurrent.ConcurrentLinkedQueue
 
 class CallbackResponse(
     val success: Boolean,
     val value: String,
 )
 
+class TimeoutHandler(
+    val key: String,
+    val handler: Handler
+)
+
+fun <T> ConcurrentLinkedQueue<T>.popFirstMatch(predicate: (T) -> Boolean): T? {
+    synchronized(this) {
+        val iterator = this.iterator()
+        while (iterator.hasNext()) {
+            val nextItem = iterator.next()
+            if (predicate(nextItem)) {
+                iterator.remove()
+                return nextItem
+            }
+        }
+        return null
+    }
+}
+
+@SuppressLint("MissingPermission")
 class Device(
     private val context: Context,
     bluetoothAdapter: BluetoothAdapter,
@@ -35,7 +67,7 @@ class Device(
     private var device: BluetoothDevice = bluetoothAdapter.getRemoteDevice(address)
     private var bluetoothGatt: BluetoothGatt? = null
     private var callbackMap = HashMap<String, ((CallbackResponse) -> Unit)>()
-    private var timeoutMap = HashMap<String, Handler>()
+    private val timeoutQueue = ConcurrentLinkedQueue<TimeoutHandler>()
     private var bondStateReceiver: BroadcastReceiver? = null
     private var currentMtu = -1
 
@@ -96,9 +128,15 @@ class Device(
             }
         }
 
+        @TargetApi(Build.VERSION_CODES.S_V2)
         override fun onCharacteristicRead(
             gatt: BluetoothGatt, characteristic: BluetoothGattCharacteristic, status: Int
         ) {
+            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
+                // handled by new callback below
+                return
+            }
+            Logger.verbose(TAG, "Using deprecated onCharacteristicRead.")
             super.onCharacteristicRead(gatt, characteristic, status)
             val key = "read|${characteristic.service.uuid}|${characteristic.uuid}"
             if (status == BluetoothGatt.GATT_SUCCESS) {
@@ -114,6 +152,24 @@ class Device(
             }
         }
 
+        @RequiresApi(api = Build.VERSION_CODES.TIRAMISU)
+        override fun onCharacteristicRead(
+            gatt: BluetoothGatt,
+            characteristic: BluetoothGattCharacteristic,
+            data: ByteArray,
+            status: Int
+        ) {
+            Logger.verbose(TAG, "Using onCharacteristicRead from API level 33.")
+            super.onCharacteristicRead(gatt, characteristic, data, status)
+            val key = "read|${characteristic.service.uuid}|${characteristic.uuid}"
+            if (status == BluetoothGatt.GATT_SUCCESS) {
+                val value = bytesToString(data)
+                resolve(key, value)
+            } else {
+                reject(key, "Reading characteristic failed.")
+            }
+        }
+
         override fun onCharacteristicWrite(
             gatt: BluetoothGatt, characteristic: BluetoothGattCharacteristic, status: Int
         ) {
@@ -127,9 +183,15 @@ class Device(
 
         }
 
+        @TargetApi(Build.VERSION_CODES.S_V2)
         override fun onCharacteristicChanged(
             gatt: BluetoothGatt, characteristic: BluetoothGattCharacteristic
         ) {
+            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
+                // handled by new callback below
+                return
+            }
+            Logger.verbose(TAG, "Using deprecated onCharacteristicChanged.")
             super.onCharacteristicChanged(gatt, characteristic)
             val notifyKey = "notification|${characteristic.service.uuid}|${characteristic.uuid}"
             val data = characteristic.value
@@ -139,9 +201,26 @@ class Device(
             }
         }
 
+        @RequiresApi(api = Build.VERSION_CODES.TIRAMISU)
+        override fun onCharacteristicChanged(
+            gatt: BluetoothGatt, characteristic: BluetoothGattCharacteristic, data: ByteArray
+        ) {
+            Logger.verbose(TAG, "Using onCharacteristicChanged from API level 33.")
+            super.onCharacteristicChanged(gatt, characteristic, data)
+            val notifyKey = "notification|${characteristic.service.uuid}|${characteristic.uuid}"
+            val value = bytesToString(data)
+            callbackMap[notifyKey]?.invoke(CallbackResponse(true, value))
+        }
+
+        @TargetApi(Build.VERSION_CODES.S_V2)
         override fun onDescriptorRead(
             gatt: BluetoothGatt, descriptor: BluetoothGattDescriptor, status: Int
         ) {
+            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
+                // handled by new callback below
+                return
+            }
+            Logger.verbose(TAG, "Using deprecated onDescriptorRead.")
             super.onDescriptorRead(gatt, descriptor, status)
             val key =
                 "readDescriptor|${descriptor.characteristic.service.uuid}|${descriptor.characteristic.uuid}|${descriptor.uuid}"
@@ -158,6 +237,22 @@ class Device(
             }
         }
 
+        @RequiresApi(api = Build.VERSION_CODES.TIRAMISU)
+        override fun onDescriptorRead(
+            gatt: BluetoothGatt, descriptor: BluetoothGattDescriptor, status: Int, data: ByteArray
+        ) {
+            Logger.verbose(TAG, "Using onDescriptorRead from API level 33.")
+            super.onDescriptorRead(gatt, descriptor, status, data)
+            val key =
+                "readDescriptor|${descriptor.characteristic.service.uuid}|${descriptor.characteristic.uuid}|${descriptor.uuid}"
+            if (status == BluetoothGatt.GATT_SUCCESS) {
+                val value = bytesToString(data)
+                resolve(key, value)
+            } else {
+                reject(key, "Reading descriptor failed.")
+            }
+        }
+
         override fun onDescriptorWrite(
             gatt: BluetoothGatt, descriptor: BluetoothGattDescriptor, status: Int
         ) {
@@ -229,7 +324,7 @@ class Device(
         return bluetoothGatt?.requestConnectionPriority(connectionPriority) ?: false
     }
 
-    fun createBond(callback: (CallbackResponse) -> Unit) {
+    fun createBond(timeout: Long, callback: (CallbackResponse) -> Unit) {
         val key = "createBond"
         callbackMap[key] = callback
         try {
@@ -250,6 +345,7 @@ class Device(
             return
         }
         // otherwise, wait for bond state change
+        setTimeout(key, "Bonding timeout.", timeout)
     }
 
     private fun createBondStateReceiver() {
@@ -260,7 +356,14 @@ class Device(
                     if (action == BluetoothDevice.ACTION_BOND_STATE_CHANGED) {
                         val key = "createBond"
                         val updatedDevice =
-                            intent.getParcelableExtra<BluetoothDevice>(BluetoothDevice.EXTRA_DEVICE)
+                            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
+                                intent.getParcelableExtra(
+                                    BluetoothDevice.EXTRA_DEVICE,
+                                    BluetoothDevice::class.java
+                                )
+                            } else {
+                                intent.getParcelableExtra<BluetoothDevice>(BluetoothDevice.EXTRA_DEVICE)
+                            }
                         // BroadcastReceiver receives bond state updates from all devices, need to filter by device
                         if (device.address == updatedDevice?.address) {
                             val bondState = intent.getIntExtra(BluetoothDevice.EXTRA_BOND_STATE, -1)
@@ -388,12 +491,21 @@ class Device(
             return
         }
         val bytes = stringToBytes(value)
-        characteristic.value = bytes
-        characteristic.writeType = writeType
-        val result = bluetoothGatt?.writeCharacteristic(characteristic)
-        if (result != true) {
-            reject(key, "Writing characteristic failed.")
-            return
+
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
+            val statusCode = bluetoothGatt?.writeCharacteristic(characteristic, bytes, writeType)
+            if (statusCode != BluetoothStatusCodes.SUCCESS) {
+                reject(key, "Writing characteristic failed with status code $statusCode.")
+                return
+            }
+        } else {
+            characteristic.value = bytes
+            characteristic.writeType = writeType
+            val result = bluetoothGatt?.writeCharacteristic(characteristic)
+            if (result != true) {
+                reject(key, "Writing characteristic failed.")
+                return
+            }
         }
         setTimeout(key, "Write timeout.", timeout)
     }
@@ -430,20 +542,32 @@ class Device(
             return
         }
 
-        if (enable) {
+        val value = if (enable) {
             if ((characteristic.properties and BluetoothGattCharacteristic.PROPERTY_NOTIFY) != 0) {
-                descriptor.value = BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE
+                BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE
             } else if ((characteristic.properties and BluetoothGattCharacteristic.PROPERTY_INDICATE) != 0) {
-                descriptor.value = BluetoothGattDescriptor.ENABLE_INDICATION_VALUE
+                BluetoothGattDescriptor.ENABLE_INDICATION_VALUE
+            } else {
+                BluetoothGattDescriptor.DISABLE_NOTIFICATION_VALUE
             }
         } else {
-            descriptor.value = BluetoothGattDescriptor.DISABLE_NOTIFICATION_VALUE
+            BluetoothGattDescriptor.DISABLE_NOTIFICATION_VALUE
         }
 
-        val resultDesc = bluetoothGatt?.writeDescriptor(descriptor)
-        if (resultDesc != true) {
-            reject(key, "Setting notification failed.")
-            return
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
+            val statusCode = bluetoothGatt?.writeDescriptor(descriptor, value)
+            if (statusCode != BluetoothStatusCodes.SUCCESS) {
+                reject(key, "Setting notification failed with status code $statusCode.")
+                return
+            }
+        } else {
+            descriptor.value = value
+            val resultDesc = bluetoothGatt?.writeDescriptor(descriptor)
+            if (resultDesc != true) {
+                reject(key, "Setting notification failed.")
+                return
+            }
+
         }
         // wait for onDescriptorWrite
     }
@@ -498,11 +622,20 @@ class Device(
             return
         }
         val bytes = stringToBytes(value)
-        descriptor.value = bytes
-        val result = bluetoothGatt?.writeDescriptor(descriptor)
-        if (result != true) {
-            reject(key, "Writing characteristic failed.")
-            return
+
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
+            val statusCode = bluetoothGatt?.writeDescriptor(descriptor, bytes)
+            if (statusCode != BluetoothStatusCodes.SUCCESS) {
+                reject(key, "Writing descriptor failed with status code $statusCode.")
+                return
+            }
+        } else {
+            descriptor.value = bytes
+            val result = bluetoothGatt?.writeDescriptor(descriptor)
+            if (result != true) {
+                reject(key, "Writing descriptor failed.")
+                return
+            }
         }
         setTimeout(key, "Write timeout.", timeout)
     }
@@ -510,20 +643,18 @@ class Device(
     private fun resolve(key: String, value: String) {
         if (callbackMap.containsKey(key)) {
             Logger.debug(TAG, "resolve: $key $value")
+            timeoutQueue.popFirstMatch { it.key == key }?.handler?.removeCallbacksAndMessages(null)
             callbackMap[key]?.invoke(CallbackResponse(true, value))
             callbackMap.remove(key)
-            timeoutMap[key]?.removeCallbacksAndMessages(null)
-            timeoutMap.remove(key)
         }
     }
 
     private fun reject(key: String, value: String) {
         if (callbackMap.containsKey(key)) {
             Logger.debug(TAG, "reject: $key $value")
+            timeoutQueue.popFirstMatch { it.key == key }?.handler?.removeCallbacksAndMessages(null)
             callbackMap[key]?.invoke(CallbackResponse(false, value))
             callbackMap.remove(key)
-            timeoutMap[key]?.removeCallbacksAndMessages(null)
-            timeoutMap.remove(key)
         }
     }
 
@@ -531,7 +662,7 @@ class Device(
         key: String, message: String, timeout: Long
     ) {
         val handler = Handler(Looper.getMainLooper())
-        timeoutMap[key] = handler
+        timeoutQueue.add(TimeoutHandler(key, handler))
         handler.postDelayed({
             reject(key, message)
         }, timeout)
@@ -544,7 +675,7 @@ class Device(
         timeout: Long,
     ) {
         val handler = Handler(Looper.getMainLooper())
-        timeoutMap[key] = handler
+        timeoutQueue.add(TimeoutHandler(key, handler))
         handler.postDelayed({
             connectionState = STATE_DISCONNECTED
             gatt?.disconnect()

package/android/src/main/java/com/capacitorjs/community/plugins/bluetoothle/DeviceScanner.kt

@@ -1,5 +1,6 @@
 package com.capacitorjs.community.plugins.bluetoothle
 
+import android.annotation.SuppressLint
 import android.app.AlertDialog
 import android.bluetooth.BluetoothAdapter
 import android.bluetooth.BluetoothDevice
@@ -27,6 +28,7 @@ class DisplayStrings(
     val noDeviceFound: String,
 )
 
+@SuppressLint("MissingPermission")
 class DeviceScanner(
     private val context: Context,
     bluetoothAdapter: BluetoothAdapter,

package/dist/docs.json

@@ -38,8 +38,13 @@
         "signature": "() => Promise<void>",
         "parameters": [],
         "returns": "Promise<void>",
-        "tags": [],
-        "docs": "Enable Bluetooth.\nOnly available on **Android**.",
+        "tags": [
+          {
+            "name": "deprecated",
+            "text": "See https://developer.android.com/reference/android/bluetooth/BluetoothAdapter#enable()"
+          }
+        ],
+        "docs": "Enable Bluetooth.\nOnly available on **Android**.\n*deprecated* See https://developer.android.com/reference/android/bluetooth/BluetoothAdapter#enable()",
         "complexTypes": [],
         "slug": "enable"
       },
@@ -48,8 +53,13 @@
         "signature": "() => Promise<void>",
         "parameters": [],
         "returns": "Promise<void>",
-        "tags": [],
-        "docs": "Disable Bluetooth.\nOnly available on **Android**.",
+        "tags": [
+          {
+            "name": "deprecated",
+            "text": "See https://developer.android.com/reference/android/bluetooth/BluetoothAdapter#disable()"
+          }
+        ],
+        "docs": "Disable Bluetooth.\nOnly available on **Android**.\n*deprecated* See https://developer.android.com/reference/android/bluetooth/BluetoothAdapter#disable()",
         "complexTypes": [],
         "slug": "disable"
       },
@@ -197,7 +207,7 @@
             "text": "callback"
           }
         ],
-        "docs": "Start scanning for BLE devices to interact with according to the filters in the options. The callback will be invoked on each device that is found.\nScanning will continue until `stopLEScan` is called. For an example, see [usage](#usage).\n**NOTE**: Use with care on **web** platform, the required API is still behind a flag in most browsers.",
+        "docs": "Start scanning for BLE devices to interact with according to the filters in the options. The callback will be invoked on each device that is found.\nScanning will continue until `stopLEScan` is called. For an example, see [usage](#usage).\n**Note**: Use with care on **web** platform, the required API is still behind a flag in most browsers.",
         "complexTypes": [
           "RequestBleDeviceOptions",
           "ScanResult"
@@ -303,12 +313,17 @@
       },
       {
         "name": "createBond",
-        "signature": "(deviceId: string) => Promise<void>",
+        "signature": "(deviceId: string, options?: TimeoutOptions | undefined) => Promise<void>",
         "parameters": [
           {
             "name": "deviceId",
             "docs": "The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))",
             "type": "string"
+          },
+          {
+            "name": "options",
+            "docs": "Options for plugin call",
+            "type": "TimeoutOptions | undefined"
           }
         ],
         "returns": "Promise<void>",
@@ -316,10 +331,16 @@
           {
             "name": "param",
             "text": "deviceId The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))"
+          },
+          {
+            "name": "param",
+            "text": "options Options for plugin call"
           }
         ],
         "docs": "Create a bond with a peripheral BLE device.\nOnly available on **Android**. On iOS bonding is handled by the OS.",
-        "complexTypes": [],
+        "complexTypes": [
+          "TimeoutOptions"
+        ],
         "slug": "createbond"
       },
       {

package/dist/esm/bleClient.d.ts

@@ -15,11 +15,15 @@ export interface BleClientInterface {
     /**
      * Enable Bluetooth.
      * Only available on **Android**.
+     * *deprecated* See https://developer.android.com/reference/android/bluetooth/BluetoothAdapter#enable()
+     * @deprecated See https://developer.android.com/reference/android/bluetooth/BluetoothAdapter#enable()
      */
     enable(): Promise<void>;
     /**
      * Disable Bluetooth.
      * Only available on **Android**.
+     * *deprecated* See https://developer.android.com/reference/android/bluetooth/BluetoothAdapter#disable()
+     * @deprecated See https://developer.android.com/reference/android/bluetooth/BluetoothAdapter#disable()
      */
     disable(): Promise<void>;
     /**
@@ -69,7 +73,7 @@ export interface BleClientInterface {
     /**
      * Start scanning for BLE devices to interact with according to the filters in the options. The callback will be invoked on each device that is found.
      * Scanning will continue until `stopLEScan` is called. For an example, see [usage](#usage).
-     * **NOTE**: Use with care on **web** platform, the required API is still behind a flag in most browsers.
+     * **Note**: Use with care on **web** platform, the required API is still behind a flag in most browsers.
      * @param options
      * @param callback
      */
@@ -105,8 +109,9 @@ export interface BleClientInterface {
      * Create a bond with a peripheral BLE device.
      * Only available on **Android**. On iOS bonding is handled by the OS.
      * @param deviceId  The ID of the device to use (obtained from [requestDevice](#requestDevice) or [requestLEScan](#requestLEScan))
+     * @param options Options for plugin call
      */
-    createBond(deviceId: string): Promise<void>;
+    createBond(deviceId: string, options?: TimeoutOptions): Promise<void>;
     /**
      * Report whether a peripheral BLE device is bonded.
      * Only available on **Android**. On iOS bonding is handled by the OS.
@@ -237,7 +242,7 @@ declare class BleClientClass implements BleClientInterface {
     getDevices(deviceIds: string[]): Promise<BleDevice[]>;
     getConnectedDevices(services: string[]): Promise<BleDevice[]>;
     connect(deviceId: string, onDisconnect?: (deviceId: string) => void, options?: TimeoutOptions): Promise<void>;
-    createBond(deviceId: string): Promise<void>;
+    createBond(deviceId: string, options?: TimeoutOptions): Promise<void>;
     isBonded(deviceId: string): Promise<boolean>;
     disconnect(deviceId: string): Promise<void>;
     getServices(deviceId: string): Promise<BleService[]>;

package/dist/esm/bleClient.js

@@ -148,9 +148,9 @@ class BleClientClass {
             await BluetoothLe.connect(Object.assign({ deviceId }, options));
         });
     }
-    async createBond(deviceId) {
+    async createBond(deviceId, options) {
         await this.queue(async () => {
-            await BluetoothLe.createBond({ deviceId });
+            await BluetoothLe.createBond(Object.assign({ deviceId }, options));
         });
     }
     async isBonded(deviceId) {