@onekeyfe/react-native-ble-utils 0.1.7 → 0.1.9

package/android/src/main/java/so/onekey/lib/ble/utils/BleUtilsModule.kt

@@ -29,6 +29,13 @@ class BleUtilsModule(private val reactContext: ReactApplicationContext) :
 
   override fun getName() = NAME
 
+  // Lets JS skip waiting for events this OS version never broadcasts.
+  override fun getConstants(): MutableMap<String, Any> =
+    hashMapOf(
+      "supportsKeyMissingEvent" to supportsKeyMissingEvent(),
+      "supportsEncryptionChangeEvent" to supportsEncryptionChangeEvent()
+    )
+
   private fun getBluetoothManager(): BluetoothManager? {
     if (bluetoothManager == null) {
       bluetoothManager =
@@ -53,6 +60,14 @@ class BleUtilsModule(private val reactContext: ReactApplicationContext) :
 
     val filter = IntentFilter(BluetoothAdapter.ACTION_STATE_CHANGED)
     filter.addAction(BluetoothDevice.ACTION_BOND_STATE_CHANGED)
+    if (supportsKeyMissingEvent()) {
+      filter.addAction(ACTION_KEY_MISSING)
+    }
+    if (supportsEncryptionChangeEvent()) {
+      filter.addAction(ACTION_ENCRYPTION_CHANGE)
+      // Tells JS when an earlier encryption result stops describing the current link.
+      filter.addAction(BluetoothDevice.ACTION_ACL_DISCONNECTED)
+    }
     val intentFilter = IntentFilter(BluetoothDevice.ACTION_PAIRING_REQUEST)
     intentFilter.priority = IntentFilter.SYSTEM_HIGH_PRIORITY
     if (Build.VERSION.SDK_INT >= 34) {
@@ -78,6 +93,24 @@ class BleUtilsModule(private val reactContext: ReactApplicationContext) :
       .emit("onDeviceBondState", params)
   }
 
+  fun emitOnDeviceKeyMissing(params: WritableMap) {
+    reactContext
+      .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
+      .emit("onDeviceKeyMissing", params)
+  }
+
+  fun emitOnDeviceEncryptionChange(params: WritableMap) {
+    reactContext
+      .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
+      .emit("onDeviceEncryptionChange", params)
+  }
+
+  fun emitOnDeviceAclDisconnected(params: WritableMap) {
+    reactContext
+      .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
+      .emit("onDeviceAclDisconnected", params)
+  }
+
   // 事件监听管理
   @ReactMethod
   fun addListener(eventName: String) {
@@ -138,6 +171,9 @@ class BleUtilsModule(private val reactContext: ReactApplicationContext) :
 
       var bonded = false
       var bonding = false
+      // False while bonding means the system (or another app) started it, e.g. the
+      // re-pairing Android runs by itself after it detects a lost bond.
+      var initiated = false
 
       when (device.bondState) {
         BluetoothDevice.BOND_BONDED -> {
@@ -154,12 +190,14 @@ class BleUtilsModule(private val reactContext: ReactApplicationContext) :
           val started = device.createBond()
           bonded = false
           bonding = started
+          initiated = started
         }
       }
 
       val map: WritableMap = Arguments.createMap()
       map.putBoolean("bonded", bonded)
       map.putBoolean("bonding", bonding)
+      map.putBoolean("initiated", initiated)
       callback.invoke(null, map)
     } catch (e: Exception) {
       Log.e(LOG_TAG, "pairDevice error: ${e.message}")
@@ -273,12 +311,67 @@ class BleUtilsModule(private val reactContext: ReactApplicationContext) :
         map.putMap("bondState", bond)
         Log.d(LOG_TAG, "onReceive BluetoothDevice BondState Change ${map}")
         module.emitOnDeviceBondState(map)
+      } else if (action == ACTION_KEY_MISSING) {
+        val device = deviceExtra(intent) ?: return
+
+        val map = Arguments.createMap()
+        map.putString("id", device.address)
+        Log.d(LOG_TAG, "onReceive BluetoothDevice KeyMissing")
+        module.emitOnDeviceKeyMissing(map)
+      } else if (action == ACTION_ENCRYPTION_CHANGE) {
+        val device = deviceExtra(intent) ?: return
+        if (!isLeTransport(intent)) return
+
+        val map = Arguments.createMap()
+        map.putString("id", device.address)
+        // HCI status: 0 on success, 6 (PIN or key missing) when the peer lost the bond.
+        map.putInt("status", intent.getIntExtra(EXTRA_ENCRYPTION_STATUS, BluetoothDevice.ERROR))
+        map.putBoolean("enabled", intent.getBooleanExtra(EXTRA_ENCRYPTION_ENABLED, false))
+        Log.d(LOG_TAG, "onReceive BluetoothDevice EncryptionChange ${map}")
+        module.emitOnDeviceEncryptionChange(map)
+      } else if (action == BluetoothDevice.ACTION_ACL_DISCONNECTED) {
+        val device = deviceExtra(intent) ?: return
+        if (!isLeTransport(intent)) return
+
+        val map = Arguments.createMap()
+        map.putString("id", device.address)
+        Log.d(LOG_TAG, "onReceive BluetoothDevice AclDisconnected")
+        module.emitOnDeviceAclDisconnected(map)
       }
     }
+
+    private fun deviceExtra(intent: Intent): BluetoothDevice? =
+      if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
+        intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE, BluetoothDevice::class.java)
+      } else {
+        intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE)
+      }
+
+    // A dual-mode peer reports BR/EDR events too; only the LE link carries GATT.
+    private fun isLeTransport(intent: Intent): Boolean {
+      if (!intent.hasExtra(EXTRA_TRANSPORT)) return true
+      return intent.getIntExtra(EXTRA_TRANSPORT, TRANSPORT_LE) == TRANSPORT_LE
+    }
   }
 
   companion object {
     const val NAME = "BleUtilsModule"
     const val LOG_TAG: String = "RNBleUtils"
+
+    // These BluetoothDevice constants are public from API 36. The literals keep this
+    // module building against older compileSdk versions.
+    const val ACTION_KEY_MISSING = "android.bluetooth.device.action.KEY_MISSING"
+    const val ACTION_ENCRYPTION_CHANGE = "android.bluetooth.device.action.ENCRYPTION_CHANGE"
+    private const val EXTRA_ENCRYPTION_STATUS = "android.bluetooth.device.extra.ENCRYPTION_STATUS"
+    private const val EXTRA_ENCRYPTION_ENABLED = "android.bluetooth.device.extra.ENCRYPTION_ENABLED"
+    // BluetoothDevice.EXTRA_TRANSPORT and TRANSPORT_LE, public from API 33 and 23.
+    private const val EXTRA_TRANSPORT = "android.bluetooth.device.extra.TRANSPORT"
+    private const val TRANSPORT_LE = 2
+    private const val LINK_SECURITY_EVENTS_MIN_SDK = 36
+
+    fun supportsKeyMissingEvent(): Boolean = Build.VERSION.SDK_INT >= LINK_SECURITY_EVENTS_MIN_SDK
+
+    fun supportsEncryptionChangeEvent(): Boolean =
+      Build.VERSION.SDK_INT >= LINK_SECURITY_EVENTS_MIN_SDK
   }
 }

package/dist/commonjs/index.js

@@ -8,6 +8,13 @@ var _reactNative = require("react-native");
 const {
   BleUtilsModule
 } = _reactNative.NativeModules;
+const readNativeFlag = name => {
+  if (_reactNative.Platform.OS !== 'android' || !BleUtilsModule) return false;
+  // Interop exposes legacy constants through getConstants(); the bridge exposes them
+  // as plain properties.
+  const constants = typeof BleUtilsModule.getConstants === 'function' ? BleUtilsModule.getConstants() : BleUtilsModule;
+  return constants?.[name] === true;
+};
 class BleUtils {
   UiEventEmitter = null;
   constructor() {
@@ -105,6 +112,68 @@ class BleUtils {
       this.UiEventEmitter?.removeAllListeners('onDeviceBondState');
     };
   }
+
+  /**
+   * [Android only]
+   * Whether this OS version and native build report `onDeviceKeyMissing`. When false
+   * the event never fires, so callers should not wait for it.
+   */
+  supportsDeviceKeyMissing() {
+    return readNativeFlag('supportsKeyMissingEvent');
+  }
+
+  /**
+   * [Android 16+ only]
+   * A bonded device could not provide its keys when the link was encrypted: the device
+   * was wiped or removed the bond. Android keeps its side of the bond, so the device
+   * stays unusable until the user forgets it in system Bluetooth settings.
+   * Each subscription is removed on its own, so several callers can listen at once.
+   * @param callback
+   */
+  onDeviceKeyMissing(callback) {
+    const subscription = this.UiEventEmitter?.addListener('onDeviceKeyMissing', callback);
+    return () => {
+      subscription?.remove();
+    };
+  }
+
+  /**
+   * [Android only]
+   * Whether this OS version and native build report `onDeviceEncryptionChange` and
+   * `onDeviceAclDisconnected`. When false those events never fire.
+   */
+  supportsDeviceEncryptionChange() {
+    return readNativeFlag('supportsEncryptionChangeEvent');
+  }
+
+  /**
+   * [Android 16+ only]
+   * The LE link to a device finished an encryption attempt. Android starts it on its own
+   * right after connecting to a bonded device, so this reports whether the stored bond
+   * still works before any request that needs encryption is sent.
+   * Each subscription is removed on its own, so several callers can listen at once.
+   * @param callback
+   */
+  onDeviceEncryptionChange(callback) {
+    const subscription = this.UiEventEmitter?.addListener('onDeviceEncryptionChange', callback);
+    return () => {
+      subscription?.remove();
+    };
+  }
+
+  /**
+   * [Android 16+ only]
+   * The LE link to a device is gone, so earlier encryption results no longer apply.
+   * Unlike a GATT disconnect, this does not fire while the system keeps the link alive
+   * for another client.
+   * @param callback
+   */
+  onDeviceAclDisconnected(callback) {
+    const subscription = this.UiEventEmitter?.addListener('onDeviceAclDisconnected', callback);
+    return () => {
+      subscription?.remove();
+    };
+  }
 }
 var _default = exports.default = new BleUtils();
 //# sourceMappingURL=index.js.map

package/dist/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNative","require","BleUtilsModule","NativeModules","BleUtils","UiEventEmitter","constructor","Platform","OS","NativeEventEmitter","checkState","Promise","fulfill","_","state","pairDevice","macAddress","resolve","bonded","bonding","reject","error","result","getConnectedPeripherals","serviceUUIDs","getBondedPeripherals","onDeviceBondState","callback","addListener","removeAllListeners","_default","exports","default"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAGA,MAAM;EAAEC;AAAe,CAAC,GAAGC,0BAAa;AAMxC,MAAMC,QAAQ,CAAC;EACbC,cAAc,GAA8B,IAAI;EAEhDC,WAAWA,CAAA,EAAG;IACZ,IAAIC,qBAAQ,CAACC,EAAE,KAAK,SAAS,EAAE;IAC/B,IAAI,CAACH,cAAc,GAAG,IAAII,+BAAkB,CAACP,cAAc,CAAC;EAC9D;EAEAQ,UAAUA,CAAA,EAAG;IACX,OAAO,IAAIC,OAAO,CAAW,CAACC,OAAO,EAAEC,CAAC,KAAK;MAC3CX,cAAc,CAACQ,UAAU,CAAEI,KAAe,IAAK;QAC7CF,OAAO,CAACE,KAAK,CAAC;MAChB,CAAC,CAAC;IACJ,CAAC,CAAC;EACJ;;EAEA;AACF;AACA;AACA;AACA;EACEC,UAAUA,CAACC,UAAkB,EAA6B;IACxD,IAAIT,qBAAQ,CAACC,EAAE,KAAK,SAAS,EAC3B,OAAOG,OAAO,CAACM,OAAO,CAAC;MACrBC,MAAM,EAAE,IAAI;MACZC,OAAO,EAAE;IACX,CAAC,CAAC;IACJ,OAAO,IAAIR,OAAO,CAAmB,CAACC,OAAO,EAAEQ,MAAM,KAAK;MACxDlB,cAAc,CAACa,UAAU,CACvBC,UAAU,EACV,CAACK,KAAoB,EAAEC,MAA+B,KAAK;QACzD,IAAID,KAAK,EAAE;UACTD,MAAM,CAACC,KAAK,CAAC;QACf,CAAC,MAAM;UACL,IAAIC,MAAM,EAAE;YACVV,OAAO,CAACU,MAAM,CAAC;UACjB,CAAC,MAAM;YACLV,OAAO,CAAC;cACNM,MAAM,EAAE,KAAK;cACbC,OAAO,EAAE;YACX,CAAC,CAAC;UACJ;QACF;MACF,CACF,CAAC;IACH,CAAC,CAAC;EACJ;;EAEA;AACF;AACA;AACA;AACA;EACEI,uBAAuBA,CAACC,YAAsB,GAAG,EAAE,EAAE;IACnD,OAAO,IAAIb,OAAO,CAAe,CAACC,OAAO,EAAEQ,MAAM,KAAK;MACpDlB,cAAc,CAACqB,uBAAuB,CACpCC,YAAY,EACZ,CAACH,KAAoB,EAAEC,MAA2B,KAAK;QACrD,IAAID,KAAK,EAAE;UACTD,MAAM,CAACC,KAAK,CAAC;QACf,CAAC,MAAM;UACL,IAAIC,MAAM,EAAE;YACVV,OAAO,CAACU,MAAM,CAAC;UACjB,CAAC,MAAM;YACLV,OAAO,CAAC,EAAE,CAAC;UACb;QACF;MACF,CACF,CAAC;IACH,CAAC,CAAC;EACJ;;EAEA;AACF;AACA;AACA;EACEa,oBAAoBA,CAAA,EAAG;IACrB,OAAO,IAAId,OAAO,CAAe,CAACC,OAAO,EAAEQ,MAAM,KAAK;MACpDlB,cAAc,CAACuB,oBAAoB,CACjC,CAACJ,KAAoB,EAAEC,MAA2B,KAAK;QACrD,IAAID,KAAK,EAAE;UACTD,MAAM,CAACC,KAAK,CAAC;QACf,CAAC,MAAM;UACL,IAAIC,MAAM,EAAE;YACVV,OAAO,CAACU,MAAM,CAAC;UACjB,CAAC,MAAM;YACLV,OAAO,CAAC,EAAE,CAAC;UACb;QACF;MACF,CACF,CAAC;IACH,CAAC,CAAC;EACJ;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;EACEc,iBAAiBA,CAACC,QAA0C,EAAE;IAC5D,IAAIpB,qBAAQ,CAACC,EAAE,KAAK,SAAS,EAAE;IAC/B,IAAI,CAACH,cAAc,EAAEuB,WAAW,CAAC,mBAAmB,EAAED,QAAQ,CAAC;IAC/D,OAAO,MAAM;MACX,IAAI,CAACtB,cAAc,EAAEwB,kBAAkB,CAAC,mBAAmB,CAAC;IAC9D,CAAC;EACH;AACF;AAAC,IAAAC,QAAA,GAAAC,OAAA,CAAAC,OAAA,GAEc,IAAI5B,QAAQ,CAAC,CAAC","ignoreList":[]}
+{"version":3,"names":["_reactNative","require","BleUtilsModule","NativeModules","readNativeFlag","name","Platform","OS","constants","getConstants","BleUtils","UiEventEmitter","constructor","NativeEventEmitter","checkState","Promise","fulfill","_","state","pairDevice","macAddress","resolve","bonded","bonding","reject","error","result","getConnectedPeripherals","serviceUUIDs","getBondedPeripherals","onDeviceBondState","callback","addListener","removeAllListeners","supportsDeviceKeyMissing","onDeviceKeyMissing","subscription","remove","supportsDeviceEncryptionChange","onDeviceEncryptionChange","onDeviceAclDisconnected","_default","exports","default"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"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","ignoreList":[]}

package/dist/module/index.js

@@ -4,6 +4,13 @@ import { NativeEventEmitter, NativeModules, Platform } from 'react-native';
 const {
   BleUtilsModule
 } = NativeModules;
+const readNativeFlag = name => {
+  if (Platform.OS !== 'android' || !BleUtilsModule) return false;
+  // Interop exposes legacy constants through getConstants(); the bridge exposes them
+  // as plain properties.
+  const constants = typeof BleUtilsModule.getConstants === 'function' ? BleUtilsModule.getConstants() : BleUtilsModule;
+  return constants?.[name] === true;
+};
 class BleUtils {
   UiEventEmitter = null;
   constructor() {
@@ -101,6 +108,68 @@ class BleUtils {
       this.UiEventEmitter?.removeAllListeners('onDeviceBondState');
     };
   }
+
+  /**
+   * [Android only]
+   * Whether this OS version and native build report `onDeviceKeyMissing`. When false
+   * the event never fires, so callers should not wait for it.
+   */
+  supportsDeviceKeyMissing() {
+    return readNativeFlag('supportsKeyMissingEvent');
+  }
+
+  /**
+   * [Android 16+ only]
+   * A bonded device could not provide its keys when the link was encrypted: the device
+   * was wiped or removed the bond. Android keeps its side of the bond, so the device
+   * stays unusable until the user forgets it in system Bluetooth settings.
+   * Each subscription is removed on its own, so several callers can listen at once.
+   * @param callback
+   */
+  onDeviceKeyMissing(callback) {
+    const subscription = this.UiEventEmitter?.addListener('onDeviceKeyMissing', callback);
+    return () => {
+      subscription?.remove();
+    };
+  }
+
+  /**
+   * [Android only]
+   * Whether this OS version and native build report `onDeviceEncryptionChange` and
+   * `onDeviceAclDisconnected`. When false those events never fire.
+   */
+  supportsDeviceEncryptionChange() {
+    return readNativeFlag('supportsEncryptionChangeEvent');
+  }
+
+  /**
+   * [Android 16+ only]
+   * The LE link to a device finished an encryption attempt. Android starts it on its own
+   * right after connecting to a bonded device, so this reports whether the stored bond
+   * still works before any request that needs encryption is sent.
+   * Each subscription is removed on its own, so several callers can listen at once.
+   * @param callback
+   */
+  onDeviceEncryptionChange(callback) {
+    const subscription = this.UiEventEmitter?.addListener('onDeviceEncryptionChange', callback);
+    return () => {
+      subscription?.remove();
+    };
+  }
+
+  /**
+   * [Android 16+ only]
+   * The LE link to a device is gone, so earlier encryption results no longer apply.
+   * Unlike a GATT disconnect, this does not fire while the system keeps the link alive
+   * for another client.
+   * @param callback
+   */
+  onDeviceAclDisconnected(callback) {
+    const subscription = this.UiEventEmitter?.addListener('onDeviceAclDisconnected', callback);
+    return () => {
+      subscription?.remove();
+    };
+  }
 }
 export default new BleUtils();
 //# sourceMappingURL=index.js.map

package/dist/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeEventEmitter","NativeModules","Platform","BleUtilsModule","BleUtils","UiEventEmitter","constructor","OS","checkState","Promise","fulfill","_","state","pairDevice","macAddress","resolve","bonded","bonding","reject","error","result","getConnectedPeripherals","serviceUUIDs","getBondedPeripherals","onDeviceBondState","callback","addListener","removeAllListeners"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["NativeEventEmitter","NativeModules","Platform","BleUtilsModule","readNativeFlag","name","OS","constants","getConstants","BleUtils","UiEventEmitter","constructor","checkState","Promise","fulfill","_","state","pairDevice","macAddress","resolve","bonded","bonding","reject","error","result","getConnectedPeripherals","serviceUUIDs","getBondedPeripherals","onDeviceBondState","callback","addListener","removeAllListeners","supportsDeviceKeyMissing","onDeviceKeyMissing","subscription","remove","supportsDeviceEncryptionChange","onDeviceEncryptionChange","onDeviceAclDisconnected"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"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","ignoreList":[]}

package/dist/typescript/commonjs/src/index.d.ts

@@ -1,8 +1,14 @@
 import { NativeEventEmitter } from 'react-native';
-import type { BleState, Peripheral, BondState, AdvertisingData } from './type';
+import type { BleState, Peripheral, BondState, AdvertisingData, KeyMissingPeripheral, EncryptionChangePeripheral, AclDisconnectedPeripheral } from './type';
 type PairDeviceResult = {
     bonded: boolean;
     bonding: boolean;
+    /**
+     * [Android only] True when this call started the bonding. False while `bonding` is
+     * true means the system started it, e.g. its own re-pairing after a lost bond.
+     * Undefined on native builds that predate the field.
+     */
+    initiated?: boolean;
 };
 declare class BleUtils {
     UiEventEmitter: NativeEventEmitter | null;
@@ -33,8 +39,46 @@ declare class BleUtils {
      * @param callback
      */
     onDeviceBondState(callback: (peripheral: Peripheral) => void): (() => void) | undefined;
+    /**
+     * [Android only]
+     * Whether this OS version and native build report `onDeviceKeyMissing`. When false
+     * the event never fires, so callers should not wait for it.
+     */
+    supportsDeviceKeyMissing(): boolean;
+    /**
+     * [Android 16+ only]
+     * A bonded device could not provide its keys when the link was encrypted: the device
+     * was wiped or removed the bond. Android keeps its side of the bond, so the device
+     * stays unusable until the user forgets it in system Bluetooth settings.
+     * Each subscription is removed on its own, so several callers can listen at once.
+     * @param callback
+     */
+    onDeviceKeyMissing(callback: (peripheral: KeyMissingPeripheral) => void): () => void;
+    /**
+     * [Android only]
+     * Whether this OS version and native build report `onDeviceEncryptionChange` and
+     * `onDeviceAclDisconnected`. When false those events never fire.
+     */
+    supportsDeviceEncryptionChange(): boolean;
+    /**
+     * [Android 16+ only]
+     * The LE link to a device finished an encryption attempt. Android starts it on its own
+     * right after connecting to a bonded device, so this reports whether the stored bond
+     * still works before any request that needs encryption is sent.
+     * Each subscription is removed on its own, so several callers can listen at once.
+     * @param callback
+     */
+    onDeviceEncryptionChange(callback: (peripheral: EncryptionChangePeripheral) => void): () => void;
+    /**
+     * [Android 16+ only]
+     * The LE link to a device is gone, so earlier encryption results no longer apply.
+     * Unlike a GATT disconnect, this does not fire while the system keeps the link alive
+     * for another client.
+     * @param callback
+     */
+    onDeviceAclDisconnected(callback: (peripheral: AclDisconnectedPeripheral) => void): () => void;
 }
 declare const _default: BleUtils;
 export default _default;
-export type { BleState, Peripheral, BondState, AdvertisingData };
+export type { BleState, Peripheral, BondState, AdvertisingData, KeyMissingPeripheral, EncryptionChangePeripheral, AclDisconnectedPeripheral, PairDeviceResult, };
 //# sourceMappingURL=index.d.ts.map

package/dist/typescript/commonjs/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAA2B,MAAM,cAAc,CAAC;AAC3E,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAG/E,KAAK,gBAAgB,GAAG;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,cAAM,QAAQ;IACZ,cAAc,EAAE,kBAAkB,GAAG,IAAI,CAAQ;;IAOjD,UAAU;IAQV;;;;OAIG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA2BzD;;;;OAIG;IACH,uBAAuB,CAAC,YAAY,GAAE,MAAM,EAAO;IAmBnD;;;OAGG;IACH,oBAAoB;IAkBpB;;;;;;OAMG;IACH,iBAAiB,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI;CAO7D;;AAED,wBAA8B;AAC9B,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAA2B,MAAM,cAAc,CAAC;AAC3E,OAAO,KAAK,EACV,QAAQ,EACR,UAAU,EACV,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EAC1B,MAAM,QAAQ,CAAC;AAGhB,KAAK,gBAAgB,GAAG;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAiBF,cAAM,QAAQ;IACZ,cAAc,EAAE,kBAAkB,GAAG,IAAI,CAAQ;;IAOjD,UAAU;IAQV;;;;OAIG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA2BzD;;;;OAIG;IACH,uBAAuB,CAAC,YAAY,GAAE,MAAM,EAAO;IAmBnD;;;OAGG;IACH,oBAAoB;IAkBpB;;;;;;OAMG;IACH,iBAAiB,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI;IAQ5D;;;;OAIG;IACH,wBAAwB;IAIxB;;;;;;;OAOG;IACH,kBAAkB,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,oBAAoB,KAAK,IAAI;IAUvE;;;;OAIG;IACH,8BAA8B;IAI9B;;;;;;;OAOG;IACH,wBAAwB,CACtB,QAAQ,EAAE,CAAC,UAAU,EAAE,0BAA0B,KAAK,IAAI;IAW5D;;;;;;OAMG;IACH,uBAAuB,CACrB,QAAQ,EAAE,CAAC,UAAU,EAAE,yBAAyB,KAAK,IAAI;CAU5D;;AAED,wBAA8B;AAC9B,YAAY,EACV,QAAQ,EACR,UAAU,EACV,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,gBAAgB,GACjB,CAAC"}

package/dist/typescript/commonjs/src/type.d.ts

@@ -40,6 +40,22 @@ export interface BondState {
     /** Android EXTRA_UNBOND_REASON, when supplied by the system. */
     reason?: number;
 }
+export interface KeyMissingPeripheral {
+    /** Device MAC address. */
+    id: string;
+}
+export interface EncryptionChangePeripheral {
+    /** Device MAC address. */
+    id: string;
+    /** HCI status of the encryption procedure: 0 on success, 6 when the peer lost the bond. */
+    status: number;
+    /** Whether the LE link is encrypted after the change. */
+    enabled: boolean;
+}
+export interface AclDisconnectedPeripheral {
+    /** Device MAC address. */
+    id: string;
+}
 export interface AdvertisingData {
     isConnectable?: boolean;
     localName?: string;

package/dist/typescript/commonjs/src/type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../../../src/type.ts"],"names":[],"mappings":"AAAA;;;KAGK;AACL,oBAAY,QAAQ;IAClB;;OAEG;IACH,OAAO,YAAY;IACnB;;OAEG;IACH,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAC3B;;OAEG;IACH,YAAY,iBAAiB;IAC7B,EAAE,OAAO;IACT,GAAG,QAAQ;IACX;;OAEG;IACH,SAAS,eAAe;IACxB;;OAEG;IACH,UAAU,gBAAgB;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,eAAe,CAAC;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../../../src/type.ts"],"names":[],"mappings":"AAAA;;;KAGK;AACL,oBAAY,QAAQ;IAClB;;OAEG;IACH,OAAO,YAAY;IACnB;;OAEG;IACH,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAC3B;;OAEG;IACH,YAAY,iBAAiB;IAC7B,EAAE,OAAO;IACT,GAAG,QAAQ;IACX;;OAEG;IACH,SAAS,eAAe;IACxB;;OAEG;IACH,UAAU,gBAAgB;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,eAAe,CAAC;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,0BAA0B;IACzC,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,2FAA2F;IAC3F,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/typescript/module/src/index.d.ts

@@ -1,8 +1,14 @@
 import { NativeEventEmitter } from 'react-native';
-import type { BleState, Peripheral, BondState, AdvertisingData } from './type';
+import type { BleState, Peripheral, BondState, AdvertisingData, KeyMissingPeripheral, EncryptionChangePeripheral, AclDisconnectedPeripheral } from './type';
 type PairDeviceResult = {
     bonded: boolean;
     bonding: boolean;
+    /**
+     * [Android only] True when this call started the bonding. False while `bonding` is
+     * true means the system started it, e.g. its own re-pairing after a lost bond.
+     * Undefined on native builds that predate the field.
+     */
+    initiated?: boolean;
 };
 declare class BleUtils {
     UiEventEmitter: NativeEventEmitter | null;
@@ -33,8 +39,46 @@ declare class BleUtils {
      * @param callback
      */
     onDeviceBondState(callback: (peripheral: Peripheral) => void): (() => void) | undefined;
+    /**
+     * [Android only]
+     * Whether this OS version and native build report `onDeviceKeyMissing`. When false
+     * the event never fires, so callers should not wait for it.
+     */
+    supportsDeviceKeyMissing(): boolean;
+    /**
+     * [Android 16+ only]
+     * A bonded device could not provide its keys when the link was encrypted: the device
+     * was wiped or removed the bond. Android keeps its side of the bond, so the device
+     * stays unusable until the user forgets it in system Bluetooth settings.
+     * Each subscription is removed on its own, so several callers can listen at once.
+     * @param callback
+     */
+    onDeviceKeyMissing(callback: (peripheral: KeyMissingPeripheral) => void): () => void;
+    /**
+     * [Android only]
+     * Whether this OS version and native build report `onDeviceEncryptionChange` and
+     * `onDeviceAclDisconnected`. When false those events never fire.
+     */
+    supportsDeviceEncryptionChange(): boolean;
+    /**
+     * [Android 16+ only]
+     * The LE link to a device finished an encryption attempt. Android starts it on its own
+     * right after connecting to a bonded device, so this reports whether the stored bond
+     * still works before any request that needs encryption is sent.
+     * Each subscription is removed on its own, so several callers can listen at once.
+     * @param callback
+     */
+    onDeviceEncryptionChange(callback: (peripheral: EncryptionChangePeripheral) => void): () => void;
+    /**
+     * [Android 16+ only]
+     * The LE link to a device is gone, so earlier encryption results no longer apply.
+     * Unlike a GATT disconnect, this does not fire while the system keeps the link alive
+     * for another client.
+     * @param callback
+     */
+    onDeviceAclDisconnected(callback: (peripheral: AclDisconnectedPeripheral) => void): () => void;
 }
 declare const _default: BleUtils;
 export default _default;
-export type { BleState, Peripheral, BondState, AdvertisingData };
+export type { BleState, Peripheral, BondState, AdvertisingData, KeyMissingPeripheral, EncryptionChangePeripheral, AclDisconnectedPeripheral, PairDeviceResult, };
 //# sourceMappingURL=index.d.ts.map

package/dist/typescript/module/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAA2B,MAAM,cAAc,CAAC;AAC3E,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAG/E,KAAK,gBAAgB,GAAG;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,cAAM,QAAQ;IACZ,cAAc,EAAE,kBAAkB,GAAG,IAAI,CAAQ;;IAOjD,UAAU;IAQV;;;;OAIG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA2BzD;;;;OAIG;IACH,uBAAuB,CAAC,YAAY,GAAE,MAAM,EAAO;IAmBnD;;;OAGG;IACH,oBAAoB;IAkBpB;;;;;;OAMG;IACH,iBAAiB,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI;CAO7D;;AAED,wBAA8B;AAC9B,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAA2B,MAAM,cAAc,CAAC;AAC3E,OAAO,KAAK,EACV,QAAQ,EACR,UAAU,EACV,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EAC1B,MAAM,QAAQ,CAAC;AAGhB,KAAK,gBAAgB,GAAG;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAiBF,cAAM,QAAQ;IACZ,cAAc,EAAE,kBAAkB,GAAG,IAAI,CAAQ;;IAOjD,UAAU;IAQV;;;;OAIG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA2BzD;;;;OAIG;IACH,uBAAuB,CAAC,YAAY,GAAE,MAAM,EAAO;IAmBnD;;;OAGG;IACH,oBAAoB;IAkBpB;;;;;;OAMG;IACH,iBAAiB,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI;IAQ5D;;;;OAIG;IACH,wBAAwB;IAIxB;;;;;;;OAOG;IACH,kBAAkB,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,oBAAoB,KAAK,IAAI;IAUvE;;;;OAIG;IACH,8BAA8B;IAI9B;;;;;;;OAOG;IACH,wBAAwB,CACtB,QAAQ,EAAE,CAAC,UAAU,EAAE,0BAA0B,KAAK,IAAI;IAW5D;;;;;;OAMG;IACH,uBAAuB,CACrB,QAAQ,EAAE,CAAC,UAAU,EAAE,yBAAyB,KAAK,IAAI;CAU5D;;AAED,wBAA8B;AAC9B,YAAY,EACV,QAAQ,EACR,UAAU,EACV,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,gBAAgB,GACjB,CAAC"}

package/dist/typescript/module/src/type.d.ts

@@ -40,6 +40,22 @@ export interface BondState {
     /** Android EXTRA_UNBOND_REASON, when supplied by the system. */
     reason?: number;
 }
+export interface KeyMissingPeripheral {
+    /** Device MAC address. */
+    id: string;
+}
+export interface EncryptionChangePeripheral {
+    /** Device MAC address. */
+    id: string;
+    /** HCI status of the encryption procedure: 0 on success, 6 when the peer lost the bond. */
+    status: number;
+    /** Whether the LE link is encrypted after the change. */
+    enabled: boolean;
+}
+export interface AclDisconnectedPeripheral {
+    /** Device MAC address. */
+    id: string;
+}
 export interface AdvertisingData {
     isConnectable?: boolean;
     localName?: string;

package/dist/typescript/module/src/type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../../../src/type.ts"],"names":[],"mappings":"AAAA;;;KAGK;AACL,oBAAY,QAAQ;IAClB;;OAEG;IACH,OAAO,YAAY;IACnB;;OAEG;IACH,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAC3B;;OAEG;IACH,YAAY,iBAAiB;IAC7B,EAAE,OAAO;IACT,GAAG,QAAQ;IACX;;OAEG;IACH,SAAS,eAAe;IACxB;;OAEG;IACH,UAAU,gBAAgB;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,eAAe,CAAC;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../../../src/type.ts"],"names":[],"mappings":"AAAA;;;KAGK;AACL,oBAAY,QAAQ;IAClB;;OAEG;IACH,OAAO,YAAY;IACnB;;OAEG;IACH,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAC3B;;OAEG;IACH,YAAY,iBAAiB;IAC7B,EAAE,OAAO;IACT,GAAG,QAAQ;IACX;;OAEG;IACH,SAAS,eAAe;IACxB;;OAEG;IACH,UAAU,gBAAgB;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,eAAe,CAAC;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,0BAA0B;IACzC,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,2FAA2F;IAC3F,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-ble-utils",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "ble uilts",
   "source": "./src/index.tsx",
   "main": "./dist/commonjs/index.js",

package/src/index.ts

@@ -1,10 +1,39 @@
 import { NativeEventEmitter, NativeModules, Platform } from 'react-native';
-import type { BleState, Peripheral, BondState, AdvertisingData } from './type';
+import type {
+  BleState,
+  Peripheral,
+  BondState,
+  AdvertisingData,
+  KeyMissingPeripheral,
+  EncryptionChangePeripheral,
+  AclDisconnectedPeripheral,
+} from './type';
 
 const { BleUtilsModule } = NativeModules;
 type PairDeviceResult = {
   bonded: boolean;
   bonding: boolean;
+  /**
+   * [Android only] True when this call started the bonding. False while `bonding` is
+   * true means the system started it, e.g. its own re-pairing after a lost bond.
+   * Undefined on native builds that predate the field.
+   */
+  initiated?: boolean;
+};
+
+type NativeConstantName =
+  | 'supportsKeyMissingEvent'
+  | 'supportsEncryptionChangeEvent';
+
+const readNativeFlag = (name: NativeConstantName): boolean => {
+  if (Platform.OS !== 'android' || !BleUtilsModule) return false;
+  // Interop exposes legacy constants through getConstants(); the bridge exposes them
+  // as plain properties.
+  const constants =
+    typeof BleUtilsModule.getConstants === 'function'
+      ? BleUtilsModule.getConstants()
+      : BleUtilsModule;
+  return constants?.[name] === true;
 };
 
 class BleUtils {
@@ -115,7 +144,91 @@ class BleUtils {
       this.UiEventEmitter?.removeAllListeners('onDeviceBondState');
     };
   }
+
+  /**
+   * [Android only]
+   * Whether this OS version and native build report `onDeviceKeyMissing`. When false
+   * the event never fires, so callers should not wait for it.
+   */
+  supportsDeviceKeyMissing() {
+    return readNativeFlag('supportsKeyMissingEvent');
+  }
+
+  /**
+   * [Android 16+ only]
+   * A bonded device could not provide its keys when the link was encrypted: the device
+   * was wiped or removed the bond. Android keeps its side of the bond, so the device
+   * stays unusable until the user forgets it in system Bluetooth settings.
+   * Each subscription is removed on its own, so several callers can listen at once.
+   * @param callback
+   */
+  onDeviceKeyMissing(callback: (peripheral: KeyMissingPeripheral) => void) {
+    const subscription = this.UiEventEmitter?.addListener(
+      'onDeviceKeyMissing',
+      callback
+    );
+    return () => {
+      subscription?.remove();
+    };
+  }
+
+  /**
+   * [Android only]
+   * Whether this OS version and native build report `onDeviceEncryptionChange` and
+   * `onDeviceAclDisconnected`. When false those events never fire.
+   */
+  supportsDeviceEncryptionChange() {
+    return readNativeFlag('supportsEncryptionChangeEvent');
+  }
+
+  /**
+   * [Android 16+ only]
+   * The LE link to a device finished an encryption attempt. Android starts it on its own
+   * right after connecting to a bonded device, so this reports whether the stored bond
+   * still works before any request that needs encryption is sent.
+   * Each subscription is removed on its own, so several callers can listen at once.
+   * @param callback
+   */
+  onDeviceEncryptionChange(
+    callback: (peripheral: EncryptionChangePeripheral) => void
+  ) {
+    const subscription = this.UiEventEmitter?.addListener(
+      'onDeviceEncryptionChange',
+      callback
+    );
+    return () => {
+      subscription?.remove();
+    };
+  }
+
+  /**
+   * [Android 16+ only]
+   * The LE link to a device is gone, so earlier encryption results no longer apply.
+   * Unlike a GATT disconnect, this does not fire while the system keeps the link alive
+   * for another client.
+   * @param callback
+   */
+  onDeviceAclDisconnected(
+    callback: (peripheral: AclDisconnectedPeripheral) => void
+  ) {
+    const subscription = this.UiEventEmitter?.addListener(
+      'onDeviceAclDisconnected',
+      callback
+    );
+    return () => {
+      subscription?.remove();
+    };
+  }
 }
 
 export default new BleUtils();
-export type { BleState, Peripheral, BondState, AdvertisingData };
+export type {
+  BleState,
+  Peripheral,
+  BondState,
+  AdvertisingData,
+  KeyMissingPeripheral,
+  EncryptionChangePeripheral,
+  AclDisconnectedPeripheral,
+  PairDeviceResult,
+};

package/src/type.ts

@@ -43,6 +43,25 @@ export interface BondState {
   reason?: number;
 }
 
+export interface KeyMissingPeripheral {
+  /** Device MAC address. */
+  id: string;
+}
+
+export interface EncryptionChangePeripheral {
+  /** Device MAC address. */
+  id: string;
+  /** HCI status of the encryption procedure: 0 on success, 6 when the peer lost the bond. */
+  status: number;
+  /** Whether the LE link is encrypted after the change. */
+  enabled: boolean;
+}
+
+export interface AclDisconnectedPeripheral {
+  /** Device MAC address. */
+  id: string;
+}
+
 export interface AdvertisingData {
   isConnectable?: boolean;
   localName?: string;