react-native-ble-nitro 1.14.0 → 1.15.0

package/src/manager.ts

@@ -5,6 +5,7 @@ import {
   BLEState as NativeBLEState,
   ScanCallback as NativeScanCallback,
   AndroidScanMode as NativeAndroidScanMode,
+  AndroidConnectionPriority as NativeAndroidConnectionPriority,
 } from './specs/NativeBleNitro';
 
 export class BleTimeoutError extends Error {
@@ -106,6 +107,12 @@ export enum AndroidScanMode {
   Opportunistic = 'Opportunistic',
 }
 
+export enum AndroidConnectionPriority {
+  Balanced = 'Balanced',
+  High = 'High',
+  LowPower = 'LowPower',
+}
+
 export type BleNitroManagerOptions = {
   restoreIdentifier?: string;
   onRestoredState?: RestoreStateCallback;
@@ -133,6 +140,15 @@ export function mapAndroidScanModeToNativeAndroidScanMode(scanMode: AndroidScanM
   return map[scanMode];
 }
 
+export function mapAndroidConnectionPriorityToNativeAndroidConnectionPriority(priority: AndroidConnectionPriority): NativeAndroidConnectionPriority {
+  const map = {
+    Balanced: NativeAndroidConnectionPriority.Balanced,
+    High: NativeAndroidConnectionPriority.High,
+    LowPower: NativeAndroidConnectionPriority.LowPower,
+  }
+  return map[priority];
+}
+
 export function convertNativeBleDeviceToBleDevice(nativeBleDevice: NativeBLEDevice): BLEDevice {
   return {
     ...nativeBleDevice,
@@ -422,6 +438,24 @@ export class BleNitroManager {
     return deviceMtu;
   }
 
+  /**
+   * Request an Android connection priority for an active connection.
+   * @param deviceId ID of the device
+   * @param priority Desired Android connection priority
+   * @returns On Android: true if the request was successfully initiated (the
+   *   priority change itself is applied asynchronously); on iOS, an error, or a
+   *   disconnected device: false
+   */
+  public requestConnectionPriority(
+    deviceId: string,
+    priority: AndroidConnectionPriority
+  ): boolean {
+    return this.Instance.requestConnectionPriority(
+      deviceId,
+      mapAndroidConnectionPriorityToNativeAndroidConnectionPriority(priority)
+    );
+  }
+
   /**
    * Read RSSI for a connected device
    * @param deviceId ID of the device

package/src/specs/NativeBleNitro.nitro.ts

@@ -49,6 +49,12 @@ export enum AndroidScanMode {
   Opportunistic = 3,
 }
 
+export enum AndroidConnectionPriority {
+  Balanced = 0,
+  High = 1,
+  LowPower = 2,
+}
+
 export interface ScanFilter {
   serviceUUIDs: string[];
   rssiThreshold: number;
@@ -98,6 +104,7 @@ export interface NativeBleNitro extends HybridObject<{ ios: 'swift'; android: 'k
   disconnect(deviceId: string, callback: OperationCallback): void;
   isConnected(deviceId: string): boolean;
   requestMTU(deviceId: string, mtu: number): number;
+  requestConnectionPriority(deviceId: string, androidConnectionPriority: AndroidConnectionPriority): boolean;
   readRSSI(deviceId: string, callback: ReadRSSICallback): void;
 
   // Service discovery
@@ -120,4 +127,4 @@ export interface NativeBleNitro extends HybridObject<{ ios: 'swift'; android: 'k
   subscribeToStateChange(stateCallback: StateCallback): OperationResult;
   unsubscribeFromStateChange(): OperationResult;
   openSettings(): Promise<void>;
-}
+}