react-native-ble-manager 12.2.2 → 12.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "react-native-ble-manager",
-    "version": "12.2.2",
+    "version": "12.4.0",
     "description": "A BLE module for react native.",
     "homepage": "https://innoveit.github.io/react-native-ble-manager/",
     "repository": {
@@ -63,7 +63,7 @@
         "postversion": "git push --follow-tags"
     },
     "resolutions": {
-        "@types/react": "^18.2.44"
+        "@types/react": "^19.2.2"
     },
     "peerDependencies": {
         "react": "*",
@@ -71,22 +71,16 @@
     },
     "devDependencies": {
         "@commitlint/config-conventional": "^19.6.0",
-        "@react-native/eslint-config": "^0.76.2",
-        "@release-it/conventional-changelog": "^9.0.3",
-        "@types/jest": "^29.5.14",
-        "@types/react": "^18.3.12",
-        "commitlint": "^19.6.0",
-        "del-cli": "^6.0.0",
-        "eslint": "^9.15.0",
-        "eslint-config-prettier": "^9.1.0",
-        "eslint-plugin-prettier": "^5.2.1",
-        "jest": "^29.7.0",
-        "prettier": "^3.3.3",
-        "react": "18.3.1",
-        "react-native": "0.76.2",
-        "@react-native/gradle-plugin": "^0.76.2",
-        "turbo": "^2.3.0",
-        "typescript": "^5.6.3",
+        "@react-native/eslint-config": "^0.82.1",
+        "@types/react": "^19.2.2",
+        "eslint": "^9.39.1",
+        "eslint-config-prettier": "^10.1.8",
+        "eslint-plugin-prettier": "^5.5.4",
+        "prettier": "^3.6.2",
+        "react": "19.2.0",
+        "react-native": "0.82.1",
+        "@react-native/gradle-plugin": "^0.82.1",
+        "typescript": "^5.9.3",
         "@expo/config-plugins": "^9.0.10",
         "expo-module-scripts": "^4.0.2"
     },

package/src/NativeBleManager.ts

@@ -1,3 +1,4 @@
+// oxlint-disable no-wrapper-object-types
 import { TurboModule, TurboModuleRegistry } from 'react-native';
 // @ts-ignore Ignore since it comes from codegen types.
 import type { EventEmitter } from 'react-native/Libraries/Types/CodegenTypes';
@@ -12,13 +13,9 @@ import type { EventEmitter } from 'react-native/Libraries/Types/CodegenTypes';
 export interface Spec extends TurboModule {
   start(options: Object, callback: (error: CallbackError) => void): void;
 
-  scan(
-    serviceUUIDStrings: string[],
-    timeoutSeconds: number,
-    allowDuplicates: boolean,
-    scanningOptions: Object,
-    callback: (error: CallbackError) => void
-  ): void;
+  isStarted(callback: (error: CallbackError, started: boolean) => void): void;
+
+  scan(scanningOptions: Object, callback: (error: CallbackError) => void): void;  
 
   stopScan(callback: (error: CallbackError) => void): void;
 
@@ -42,7 +39,7 @@ export interface Spec extends TurboModule {
 
   readRSSI(
     peripheralUUID: string,
-    callback: (error: string | null, rssi: number) => void
+    callback: (error: CallbackError, rssi: number) => void
   ): void;
 
   readDescriptor(
@@ -50,7 +47,7 @@ export interface Spec extends TurboModule {
     serviceUUID: string,
     characteristicUUID: string,
     descriptorUUID: string,
-    callback: (error: string | null, data: number[]) => void
+    callback: (error: CallbackError, data: number[]) => void
   ): void;
 
   writeDescriptor(
@@ -58,12 +55,12 @@ export interface Spec extends TurboModule {
     serviceUUID: string,
     characteristicUUID: string,
     descriptorUUID: string,
-    data: object[],
-    callback: (error: string | null) => void
+    data: Object[],
+    callback: (error: CallbackError) => void
   ): void;
 
   getDiscoveredPeripherals(
-    callback: (error: string | null, result: Peripheral[] | null) => void
+    callback: (error: CallbackError, result: Peripheral[] | null) => void
   ): void;
 
   checkState(callback: (state: BleState) => void): void;
@@ -72,26 +69,26 @@ export interface Spec extends TurboModule {
     peripheralUUID: string,
     serviceUUID: string,
     characteristicUUID: string,
-    message: object[],
+    message: Object[],
     maxByteSize: number,
-    callback: (error: string | null) => void
+    callback: (error: CallbackError) => void
   ): void;
 
   writeWithoutResponse(
     peripheralUUID: string,
     serviceUUID: string,
     characteristicUUID: string,
-    message: object[],
+    message: Object[],
     maxByteSize: number,
     queueSleepTime: number,
-    callback: (error: string | null) => void
+    callback: (error: CallbackError) => void
   ): void;
 
   read(
     peripheralUUID: string,
     serviceUUID: string,
     characteristicUUID: string,
-    callback: (error: string | null, data: number[]) => void
+    callback: (error: CallbackError, data: number[]) => void
   ): void;
 
   startNotificationWithBuffer(
@@ -99,26 +96,26 @@ export interface Spec extends TurboModule {
     serviceUUID: string,
     characteristicUUID: string,
     bufferLength: number,
-    callback: (error: string | null) => void
+    callback: (error: CallbackError) => void
   ): void;
 
   startNotification(
     peripheralUUID: string,
     serviceUUID: string,
     characteristicUUID: string,
-    callback: (error: string | null) => void
+    callback: (error: CallbackError) => void
   ): void;
 
   stopNotification(
     peripheralUUID: string,
     serviceUUID: string,
     characteristicUUID: string,
-    callback: (error: string | null) => void
+    callback: (error: CallbackError) => void
   ): void;
 
   getConnectedPeripherals(
     serviceUUIDStrings: string[],
-    callback: (error: string | null, result: Peripheral[] | null) => void
+    callback: (error: CallbackError, result: Peripheral[] | null) => void
   ): void;
 
   isPeripheralConnected(
@@ -126,66 +123,66 @@ export interface Spec extends TurboModule {
     callback: (error: Peripheral[]) => void
   ): void;
 
-  isScanning(callback: (error: string | null, status: boolean) => void): void;
+  isScanning(callback: (error: CallbackError, status: boolean) => void): void;
 
   getMaximumWriteValueLengthForWithoutResponse(
     peripheralUUID: string,
-    callback: (error: string | null, max: number) => void
+    callback: (error: CallbackError, max: number) => void
   ): void;
 
   getMaximumWriteValueLengthForWithResponse(
     deviceUUID: string,
-    callback: (error: string | null, max: number) => void
+    callback: (error: CallbackError, max: number) => void
   ): void;
 
-  enableBluetooth(callback: (error: string | null) => void): void;
+  enableBluetooth(callback: (error: CallbackError) => void): void;
 
   getBondedPeripherals(
-    callback: (error: string | null, result: Peripheral[] | null) => void
+    callback: (error: CallbackError, result: Peripheral[] | null) => void
   ): void;
 
   createBond(
     peripheralUUID: string,
     devicePin: string,
-    callback: (error: string | null) => void
+    callback: (error: CallbackError) => void
   ): void;
 
   removeBond(
     peripheralUUID: string,
-    callback: (error: string | null) => void
+    callback: (error: CallbackError) => void
   ): void;
 
   removePeripheral(
     peripheralUUID: string,
-    callback: (error: string | null) => void
+    callback: (error: CallbackError) => void
   ): void;
 
   requestMTU(
     peripheralUUID: string,
     mtu: number,
-    callback: (error: string | null, mtu: number) => void
+    callback: (error: CallbackError, mtu: number) => void
   ): void;
 
   requestConnectionPriority(
     peripheralUUID: string,
     connectionPriority: number,
-    callback: (error: string | null, status: boolean) => void
+    callback: (error: CallbackError, status: boolean) => void
   ): void;
 
   refreshCache(
     peripheralUUID: string,
-    callback: (error: string | null, result: boolean) => void
+    callback: (error: CallbackError, result: boolean) => void
   ): void;
 
   setName(name: string): void;
 
   getAssociatedPeripherals(
-    callback: (error: string | null, peripherals: Peripheral[] | null) => void
+    callback: (error: CallbackError, peripherals: Peripheral[] | null) => void
   ): void;
 
   removeAssociatedPeripheral(
     peripheralUUID: string,
-    callback: (error: string | null) => void
+    callback: (error: CallbackError) => void
   ): void;
 
   supportsCompanion(callback: (supports: boolean) => void): void;
@@ -193,7 +190,7 @@ export interface Spec extends TurboModule {
   companionScan(
     serviceUUIDs: string[],
     option: Object,
-    callback: (error: string | null, peripheral: Peripheral | null) => void
+    callback: (error: CallbackError, peripheral: Peripheral | null) => void
   ): void;
 
   /**
@@ -232,30 +229,16 @@ export type Peripheral = {
   advertising: {
     isConnectable?: boolean;
     localName?: string | null;
-    rawData?: {
-      CDVType: number[];
-      bytes: number[];
-      data: string;
-    };
+    rawData?: { CDVType: number[]; bytes: number[]; data: string };
     manufacturerData?:
-      | {
-          CDVType: number[];
-          bytes: number[];
-          data: string;
-        }[]
+      | { CDVType: number[]; bytes: number[]; data: string }[]
       | null;
     manufacturerRawData?: {
       CDVType: number[];
       bytes: number[];
       data: string;
     } | null;
-    serviceData?:
-      | {
-          CDVType: number[];
-          bytes: number[];
-          data: string;
-        }[]
-      | null;
+    serviceData?: { CDVType: number[]; bytes: number[]; data: string }[] | null;
     serviceUUIDs?: string[];
     txPowerLevel?: number;
   };
@@ -268,30 +251,16 @@ export type PeripheralInfo = {
   advertising: {
     isConnectable?: boolean;
     localName?: string | null;
-    rawData?: {
-      CDVType: number[];
-      bytes: number[];
-      data: string;
-    } | null;
+    rawData?: { CDVType: number[]; bytes: number[]; data: string } | null;
     manufacturerData?:
-      | {
-          CDVType: number[];
-          bytes: number[];
-          data: string;
-        }[]
+      | { CDVType: number[]; bytes: number[]; data: string }[]
       | null;
     manufacturerRawData?: {
       CDVType: number[];
       bytes: number[];
       data: string;
     } | null;
-    serviceData?:
-      | {
-          CDVType: number[];
-          bytes: number[];
-          data: string;
-        }[]
-      | null;
+    serviceData?: { CDVType: number[]; bytes: number[]; data: string }[] | null;
     serviceUUIDs?: string[];
     txPowerLevel?: number;
   };
@@ -311,21 +280,14 @@ export type PeripheralInfo = {
     };
     characteristic: string;
     service: string;
-    descriptors?: {
-      value: string;
-      uuid: string;
-    }[];
+    descriptors?: { value: string; uuid: string }[];
   }[];
   services?: { uuid: string }[];
 };
 
-export type EventStopScan = {
-  status: number;
-};
+export type EventStopScan = { status: number };
 
-export type EventDidUpdateState = {
-  state: string;
-};
+export type EventDidUpdateState = { state: string };
 
 export type EventDiscoverPeripheral = {
   id: string;
@@ -412,6 +374,4 @@ export type EventCompanionPeripheral = {
   };
 };
 
-export type EventCompanionFailure = {
-  error: string;
-};
+export type EventCompanionFailure = { error: string };

package/src/index.ts

@@ -1,7 +1,4 @@
-import {
-  EventSubscription,
-  NativeModules,
-} from 'react-native';
+import { EventSubscription, NativeModules } from 'react-native';
 import {
   BleScanCallbackType,
   BleScanMatchCount,
@@ -16,6 +13,7 @@ import {
   ScanOptions,
   StartOptions,
 } from './types';
+import { CallbackError } from './NativeBleManager';
 export * from './types';
 
 // @ts-expect-error This applies the turbo module version only when turbo is enabled for backwards compatibility.
@@ -431,6 +429,22 @@ class BleManager {
     });
   }
 
+  /**
+   * Check if the BLE manager has been started.
+   * @returns boolean promise indicating if the manager is started.
+   */
+  isStarted(): Promise<boolean> {
+    return new Promise((fulfill, reject) => {
+      BleManagerModule.isStarted((error: CallbackError, started: boolean) => {
+        if (error) {
+          reject(error);
+        } else {
+          fulfill(started);
+        }
+      });
+    });
+  }
+
   /**
    *
    * @param serviceUUIDs
@@ -439,15 +453,16 @@ class BleManager {
    * @param scanningOptions optional map of properties to fine-tune scan behavior, see DOCS.
    * @returns
    */
-  scan(
-    serviceUUIDs: string[],
-    seconds: number,
-    allowDuplicates?: boolean,
-    scanningOptions: ScanOptions = {}
-  ) {
+  scan(scanningOptions: ScanOptions = {}) {
     return new Promise<void>((fulfill, reject) => {
-      if (allowDuplicates == null) {
-        allowDuplicates = false;
+      if (scanningOptions.serviceUUIDs == null) {
+        scanningOptions.serviceUUIDs = [];
+      }
+      if (scanningOptions.seconds == null) {
+        scanningOptions.seconds = 0;
+      }
+      if (scanningOptions.allowDuplicates == null) {
+        scanningOptions.allowDuplicates = false;
       }
 
       // (ANDROID) Match as many advertisement per filter as hw could allow
@@ -491,19 +506,13 @@ class BleManager {
         }
       }
 
-      BleManagerModule.scan(
-        serviceUUIDs,
-        seconds,
-        allowDuplicates,
-        scanningOptions,
-        (error: string | null) => {
-          if (error) {
-            reject(error);
-          } else {
-            fulfill();
-          }
+      BleManagerModule.scan(scanningOptions, (error: string | null) => {
+        if (error) {
+          reject(error);
+        } else {
+          fulfill();
         }
-      );
+      });
     });
   }
 

package/src/types.ts

@@ -94,6 +94,12 @@ export interface ConnectOptions {
  * https://developer.android.com/reference/android/bluetooth/le/ScanSettings
  */
 export interface ScanOptions {
+  serviceUUIDs?: string[];
+  seconds?: number;
+  /**
+   *  iOS only: whether to allow duplicate peripheral during a scan
+   */
+  allowDuplicates?: boolean;
   /**
    * This will only works if a ScanFilter is active. Otherwise, may not retrieve any result.
    * See https://developer.android.com/reference/android/bluetooth/le/ScanSettings#MATCH_NUM_FEW_ADVERTISEMENT.
@@ -158,6 +164,10 @@ export interface ScanOptions {
    */
   single?: boolean;
   companion?: boolean;
+  /**
+   * [Android O+] Deliver scan results using a PendingIntent instead of the default callback.
+   */
+  useScanIntent?: boolean;
 }
 
 export interface CompanionScanOptions {