@onekeyfe/react-native-ble-utils 0.1.6 → 0.1.8

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

@@ -29,6 +29,10 @@ class BleUtilsModule(private val reactContext: ReactApplicationContext) :
 
   override fun getName() = NAME
 
+  // Lets JS skip waiting for an event this OS version never broadcasts.
+  override fun getConstants(): MutableMap<String, Any> =
+    hashMapOf("supportsKeyMissingEvent" to supportsKeyMissingEvent())
+
   private fun getBluetoothManager(): BluetoothManager? {
     if (bluetoothManager == null) {
       bluetoothManager =
@@ -53,6 +57,9 @@ 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)
+    }
     val intentFilter = IntentFilter(BluetoothDevice.ACTION_PAIRING_REQUEST)
     intentFilter.priority = IntentFilter.SYSTEM_HIGH_PRIORITY
     if (Build.VERSION.SDK_INT >= 34) {
@@ -78,6 +85,12 @@ class BleUtilsModule(private val reactContext: ReactApplicationContext) :
       .emit("onDeviceBondState", params)
   }
 
+  fun emitOnDeviceKeyMissing(params: WritableMap) {
+    reactContext
+      .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
+      .emit("onDeviceKeyMissing", params)
+  }
+
   // 事件监听管理
   @ReactMethod
   fun addListener(eventName: String) {
@@ -138,6 +151,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 +170,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}")
@@ -262,12 +280,31 @@ class BleUtilsModule(private val reactContext: ReactApplicationContext) :
         val bond = Arguments.createMap()
         bond.putString("state", bondStateStr)
         bond.putString("preState", prevBondStateStr)
+        // EXTRA_UNBOND_REASON is not exposed by the public Android SDK.
+        val reasonExtra = "android.bluetooth.device.extra.REASON"
+        if (bondState == BluetoothDevice.BOND_NONE && intent.hasExtra(reasonExtra)) {
+          bond.putInt("reason", intent.getIntExtra(reasonExtra, BluetoothDevice.ERROR))
+        }
 
         val peripheral = Peripheral(device!!)
         val map = peripheral.asWritableMap()
         map.putMap("bondState", bond)
         Log.d(LOG_TAG, "onReceive BluetoothDevice BondState Change ${map}")
         module.emitOnDeviceBondState(map)
+      } else if (action == ACTION_KEY_MISSING) {
+        val device: BluetoothDevice? = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
+          intent.getParcelableExtra(
+            BluetoothDevice.EXTRA_DEVICE, BluetoothDevice::class.java
+          )
+        } else {
+          intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE)
+        }
+        if (device == null) return
+
+        val map = Arguments.createMap()
+        map.putString("id", device.address)
+        Log.d(LOG_TAG, "onReceive BluetoothDevice KeyMissing")
+        module.emitOnDeviceKeyMissing(map)
       }
     }
   }
@@ -275,5 +312,12 @@ class BleUtilsModule(private val reactContext: ReactApplicationContext) :
   companion object {
     const val NAME = "BleUtilsModule"
     const val LOG_TAG: String = "RNBleUtils"
+
+    // BluetoothDevice.ACTION_KEY_MISSING is public from API 36. The literal keeps this
+    // module building against older compileSdk versions.
+    const val ACTION_KEY_MISSING = "android.bluetooth.device.action.KEY_MISSING"
+    private const val KEY_MISSING_MIN_SDK = 36
+
+    fun supportsKeyMissingEvent(): Boolean = Build.VERSION.SDK_INT >= KEY_MISSING_MIN_SDK
   }
 }

package/dist/commonjs/index.js

@@ -8,6 +8,13 @@ var _reactNative = require("react-native");
 const {
   BleUtilsModule
 } = _reactNative.NativeModules;
+const readSupportsKeyMissingEvent = () => {
+  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?.supportsKeyMissingEvent === true;
+};
 class BleUtils {
   UiEventEmitter = null;
   constructor() {
@@ -105,6 +112,30 @@ 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 readSupportsKeyMissingEvent();
+  }
+
+  /**
+   * [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();
+    };
+  }
 }
 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":"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","ignoreList":[]}
+{"version":3,"names":["_reactNative","require","BleUtilsModule","NativeModules","readSupportsKeyMissingEvent","Platform","OS","constants","getConstants","supportsKeyMissingEvent","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","_default","exports","default"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AASA,MAAM;EAAEC;AAAe,CAAC,GAAGC,0BAAa;AAYxC,MAAMC,2BAA2B,GAAGA,CAAA,KAAe;EACjD,IAAIC,qBAAQ,CAACC,EAAE,KAAK,SAAS,IAAI,CAACJ,cAAc,EAAE,OAAO,KAAK;EAC9D;EACA;EACA,MAAMK,SAAS,GACb,OAAOL,cAAc,CAACM,YAAY,KAAK,UAAU,GAC7CN,cAAc,CAACM,YAAY,CAAC,CAAC,GAC7BN,cAAc;EACpB,OAAOK,SAAS,EAAEE,uBAAuB,KAAK,IAAI;AACpD,CAAC;AAED,MAAMC,QAAQ,CAAC;EACbC,cAAc,GAA8B,IAAI;EAEhDC,WAAWA,CAAA,EAAG;IACZ,IAAIP,qBAAQ,CAACC,EAAE,KAAK,SAAS,EAAE;IAC/B,IAAI,CAACK,cAAc,GAAG,IAAIE,+BAAkB,CAACX,cAAc,CAAC;EAC9D;EAEAY,UAAUA,CAAA,EAAG;IACX,OAAO,IAAIC,OAAO,CAAW,CAACC,OAAO,EAAEC,CAAC,KAAK;MAC3Cf,cAAc,CAACY,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,IAAIf,qBAAQ,CAACC,EAAE,KAAK,SAAS,EAC3B,OAAOS,OAAO,CAACM,OAAO,CAAC;MACrBC,MAAM,EAAE,IAAI;MACZC,OAAO,EAAE;IACX,CAAC,CAAC;IACJ,OAAO,IAAIR,OAAO,CAAmB,CAACC,OAAO,EAAEQ,MAAM,KAAK;MACxDtB,cAAc,CAACiB,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;MACpDtB,cAAc,CAACyB,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;MACpDtB,cAAc,CAAC2B,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,IAAI1B,qBAAQ,CAACC,EAAE,KAAK,SAAS,EAAE;IAC/B,IAAI,CAACK,cAAc,EAAEqB,WAAW,CAAC,mBAAmB,EAAED,QAAQ,CAAC;IAC/D,OAAO,MAAM;MACX,IAAI,CAACpB,cAAc,EAAEsB,kBAAkB,CAAC,mBAAmB,CAAC;IAC9D,CAAC;EACH;;EAEA;AACF;AACA;AACA;AACA;EACEC,wBAAwBA,CAAA,EAAG;IACzB,OAAO9B,2BAA2B,CAAC,CAAC;EACtC;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACE+B,kBAAkBA,CAACJ,QAAoD,EAAE;IACvE,MAAMK,YAAY,GAAG,IAAI,CAACzB,cAAc,EAAEqB,WAAW,CACnD,oBAAoB,EACpBD,QACF,CAAC;IACD,OAAO,MAAM;MACXK,YAAY,EAAEC,MAAM,CAAC,CAAC;IACxB,CAAC;EACH;AACF;AAAC,IAAAC,QAAA,GAAAC,OAAA,CAAAC,OAAA,GAEc,IAAI9B,QAAQ,CAAC,CAAC","ignoreList":[]}

package/dist/module/index.js

@@ -4,6 +4,13 @@ import { NativeEventEmitter, NativeModules, Platform } from 'react-native';
 const {
   BleUtilsModule
 } = NativeModules;
+const readSupportsKeyMissingEvent = () => {
+  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?.supportsKeyMissingEvent === true;
+};
 class BleUtils {
   UiEventEmitter = null;
   constructor() {
@@ -101,6 +108,30 @@ 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 readSupportsKeyMissingEvent();
+  }
+
+  /**
+   * [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();
+    };
+  }
 }
 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","readSupportsKeyMissingEvent","OS","constants","getConstants","supportsKeyMissingEvent","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"],"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 } 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,23 @@ 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;
 }
 declare const _default: BleUtils;
 export default _default;
-export type { BleState, Peripheral, BondState, AdvertisingData };
+export type { BleState, Peripheral, BondState, AdvertisingData, KeyMissingPeripheral, 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,EACrB,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;AAaF,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;CASxE;;AAED,wBAA8B;AAC9B,YAAY,EACV,QAAQ,EACR,UAAU,EACV,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,gBAAgB,GACjB,CAAC"}

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

@@ -37,6 +37,12 @@ export interface Peripheral {
 export interface BondState {
     state: string;
     preState: string;
+    /** Android EXTRA_UNBOND_REASON, when supplied by the system. */
+    reason?: number;
+}
+export interface KeyMissingPeripheral {
+    /** Device MAC address. */
+    id: string;
 }
 export interface AdvertisingData {
     isConnectable?: boolean;

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;CAClB;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,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 } 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,23 @@ 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;
 }
 declare const _default: BleUtils;
 export default _default;
-export type { BleState, Peripheral, BondState, AdvertisingData };
+export type { BleState, Peripheral, BondState, AdvertisingData, KeyMissingPeripheral, 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,EACrB,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;AAaF,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;CASxE;;AAED,wBAA8B;AAC9B,YAAY,EACV,QAAQ,EACR,UAAU,EACV,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,gBAAgB,GACjB,CAAC"}

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

@@ -37,6 +37,12 @@ export interface Peripheral {
 export interface BondState {
     state: string;
     preState: string;
+    /** Android EXTRA_UNBOND_REASON, when supplied by the system. */
+    reason?: number;
+}
+export interface KeyMissingPeripheral {
+    /** Device MAC address. */
+    id: string;
 }
 export interface AdvertisingData {
     isConnectable?: boolean;

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;CAClB;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,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.6",
+  "version": "0.1.8",
   "description": "ble uilts",
   "source": "./src/index.tsx",
   "main": "./dist/commonjs/index.js",

package/src/index.ts

@@ -1,10 +1,33 @@
 import { NativeEventEmitter, NativeModules, Platform } from 'react-native';
-import type { BleState, Peripheral, BondState, AdvertisingData } from './type';
+import type {
+  BleState,
+  Peripheral,
+  BondState,
+  AdvertisingData,
+  KeyMissingPeripheral,
+} 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;
+};
+
+const readSupportsKeyMissingEvent = (): 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?.supportsKeyMissingEvent === true;
 };
 
 class BleUtils {
@@ -115,7 +138,41 @@ 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 readSupportsKeyMissingEvent();
+  }
+
+  /**
+   * [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();
+    };
+  }
 }
 
 export default new BleUtils();
-export type { BleState, Peripheral, BondState, AdvertisingData };
+export type {
+  BleState,
+  Peripheral,
+  BondState,
+  AdvertisingData,
+  KeyMissingPeripheral,
+  PairDeviceResult,
+};

package/src/type.ts

@@ -39,6 +39,13 @@ export interface Peripheral {
 export interface BondState {
   state: string;
   preState: string;
+  /** Android EXTRA_UNBOND_REASON, when supplied by the system. */
+  reason?: number;
+}
+
+export interface KeyMissingPeripheral {
+  /** Device MAC address. */
+  id: string;
 }
 
 export interface AdvertisingData {