react-native-ble-nitro 1.11.0 → 1.12.0

package/lib/commonjs/specs/NativeBleNitro.nitro.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeBleNitro.nitro.d.ts","sourceRoot":"","sources":["../../../src/specs/NativeBleNitro.nitro.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"NativeBleNitro.nitro.d.ts","sourceRoot":"","sources":["../../../src/specs/NativeBleNitro.nitro.ts"],"names":[],"mappings":"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"}

package/lib/index.d.ts

@@ -1,2 +1,2 @@
-export { type ByteArray, type ScanFilter, type BLEDevice, type ScanCallback, type ManufacturerDataEntry, type ManufacturerData, type ConnectionCallback, type DisconnectEventCallback, type OperationCallback, type CharacteristicUpdateCallback, type Subscription, type AsyncSubscription, type BleNitroManagerOptions, BLEState, AndroidScanMode, BleNitroManager, } from "./manager";
+export { type ByteArray, type ScanFilter, type BLEDevice, type ScanCallback, type ManufacturerDataEntry, type ManufacturerData, type ConnectionCallback, type DisconnectEventCallback, type OperationCallback, type CharacteristicUpdateCallback, type Subscription, type AsyncSubscription, type BleNitroManagerOptions, BLEState, AndroidScanMode, BleNitroManager, BleTimeoutError, } from "./manager";
 export { BleNitro } from './singleton';

package/lib/index.js

@@ -1,2 +1,2 @@
-export { BLEState, AndroidScanMode, BleNitroManager, } from "./manager";
+export { BLEState, AndroidScanMode, BleNitroManager, BleTimeoutError, } from "./manager";
 export { BleNitro } from './singleton';

package/lib/manager.d.ts

@@ -1,4 +1,7 @@
 import { BLEDevice as NativeBLEDevice, BLEState as NativeBLEState, AndroidScanMode as NativeAndroidScanMode } from './specs/NativeBleNitro';
+export declare class BleTimeoutError extends Error {
+    constructor(operation: string, ms: number);
+}
 export type ByteArray = number[];
 export interface ScanFilter {
     serviceUUIDs?: string[];
@@ -173,7 +176,10 @@ export declare class BleNitroManager {
      */
     getCharacteristics(deviceId: string, serviceId: string): string[];
     /**
-     * Get services and characteristics for a connected device
+     * Get services and characteristics for a connected device.
+     * Uses a native method that waits for both service and characteristic
+     * discovery to complete before reading, avoiding the CoreBluetooth race
+     * where didDiscoverServices may not re-fire for cached services.
      * @param deviceId ID of the device
      * @returns Promise resolving to array of service and characteristic UUIDs
      * @see getServices
@@ -183,6 +189,8 @@ export declare class BleNitroManager {
         uuid: string;
         characteristics: string[];
     }[]>;
+    private static readonly DISCOVERY_TIMEOUT_MS;
+    private _discoverServicesWithCharacteristics;
     /**
      * Read a characteristic value
      * @param deviceId ID of the device
@@ -218,6 +226,14 @@ export declare class BleNitroManager {
      * @returns Promise resolving when unsubscription is complete
      */
     unsubscribeFromCharacteristic(deviceId: string, serviceId: string, characteristicId: string): Promise<void>;
+    /**
+     * Check if currently subscribed to a characteristic's notifications
+     * @param deviceId ID of the device
+     * @param serviceId ID of the service
+     * @param characteristicId ID of the characteristic
+     * @returns Boolean indicating if subscribed to notifications
+     */
+    isSubscribedToCharacteristic(deviceId: string, serviceId: string, characteristicId: string): boolean;
     /**
      * Check if Bluetooth is enabled
      * @returns returns Boolean according to Bluetooth state

package/lib/manager.js

@@ -1,5 +1,18 @@
 import BleNitroNativeFactory from './specs/NativeBleNitroFactory';
 import { AndroidScanMode as NativeAndroidScanMode, } from './specs/NativeBleNitro';
+export class BleTimeoutError extends Error {
+    constructor(operation, ms) {
+        super(`${operation} timed out after ${ms}ms`);
+        this.name = 'BleTimeoutError';
+    }
+}
+function withTimeout(promise, ms, operation) {
+    let timer;
+    const timeout = new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new BleTimeoutError(operation, ms)), ms);
+    });
+    return Promise.race([promise, timeout]).finally(() => clearTimeout(timer));
+}
 export var BLEState;
 (function (BLEState) {
     BLEState["Unknown"] = "Unknown";
@@ -357,21 +370,39 @@ export class BleNitroManager {
         return BleNitroManager.normalizeGattUUIDs(characteristics);
     }
     /**
-     * Get services and characteristics for a connected device
+     * Get services and characteristics for a connected device.
+     * Uses a native method that waits for both service and characteristic
+     * discovery to complete before reading, avoiding the CoreBluetooth race
+     * where didDiscoverServices may not re-fire for cached services.
      * @param deviceId ID of the device
      * @returns Promise resolving to array of service and characteristic UUIDs
      * @see getServices
      * @see getCharacteristics
      */
     async getServicesWithCharacteristics(deviceId) {
-        await this.discoverServices(deviceId);
-        const services = await this.getServices(deviceId);
-        return services.map((service) => {
-            return {
-                uuid: service,
-                characteristics: this.getCharacteristics(deviceId, service),
-            };
+        await this._discoverServicesWithCharacteristics(deviceId);
+        const services = this.Instance.getServices(deviceId);
+        return BleNitroManager.normalizeGattUUIDs(services).map((service) => ({
+            uuid: service,
+            characteristics: this.getCharacteristics(deviceId, service),
+        }));
+    }
+    _discoverServicesWithCharacteristics(deviceId) {
+        const inner = new Promise((resolve, reject) => {
+            if (!this.isConnected(deviceId)) {
+                reject(new Error('Device not connected'));
+                return;
+            }
+            this.Instance.discoverServicesWithCharacteristics(deviceId, (success, error) => {
+                if (success) {
+                    resolve();
+                }
+                else {
+                    reject(new Error(error));
+                }
+            });
         });
+        return withTimeout(inner, BleNitroManager.DISCOVERY_TIMEOUT_MS, 'discoverServicesWithCharacteristics');
     }
     /**
      * Read a characteristic value
@@ -480,6 +511,18 @@ export class BleNitroManager {
             });
         });
     }
+    /**
+     * Check if currently subscribed to a characteristic's notifications
+     * @param deviceId ID of the device
+     * @param serviceId ID of the service
+     * @param characteristicId ID of the characteristic
+     * @returns Boolean indicating if subscribed to notifications
+     */
+    isSubscribedToCharacteristic(deviceId, serviceId, characteristicId) {
+        // No isConnected guard — both native implementations already return false
+        // for disconnected devices, and an extra check would introduce a TOCTOU race.
+        return this.Instance.isSubscribedToCharacteristic(deviceId, BleNitroManager.normalizeGattUUID(serviceId), BleNitroManager.normalizeGattUUID(characteristicId));
+    }
     /**
      * Check if Bluetooth is enabled
      * @returns returns Boolean according to Bluetooth state
@@ -540,3 +583,4 @@ export class BleNitroManager {
         return this.Instance.openSettings();
     }
 }
+BleNitroManager.DISCOVERY_TIMEOUT_MS = 30000;

package/lib/specs/NativeBleNitro.nitro.d.ts

@@ -74,12 +74,15 @@ export interface NativeBleNitro extends HybridObject<{
     requestMTU(deviceId: string, mtu: number): number;
     readRSSI(deviceId: string, callback: ReadRSSICallback): void;
     discoverServices(deviceId: string, callback: OperationCallback): void;
+    /** Discover services and wait for all characteristic discovery to complete before resolving. */
+    discoverServicesWithCharacteristics(deviceId: string, callback: OperationCallback): void;
     getServices(deviceId: string): string[];
     getCharacteristics(deviceId: string, serviceId: string): string[];
     readCharacteristic(deviceId: string, serviceId: string, characteristicId: string, callback: ReadCharacteristicCallback): void;
     writeCharacteristic(deviceId: string, serviceId: string, characteristicId: string, data: BLEValue, withResponse: boolean, callback: WriteCharacteristicCallback): void;
     subscribeToCharacteristic(deviceId: string, serviceId: string, characteristicId: string, updateCallback: CharacteristicCallback, completionCallback: OperationCallback): void;
     unsubscribeFromCharacteristic(deviceId: string, serviceId: string, characteristicId: string, callback: OperationCallback): void;
+    isSubscribedToCharacteristic(deviceId: string, serviceId: string, characteristicId: string): boolean;
     requestBluetoothEnable(callback: OperationCallback): void;
     state(): BLEState;
     subscribeToStateChange(stateCallback: StateCallback): OperationResult;

package/nitrogen/generated/android/c++/JHybridNativeBleNitroSpec.cpp

@@ -173,6 +173,10 @@ namespace margelo::nitro::co::zyke::ble {
     static const auto method = _javaPart->javaClassStatic()->getMethod<void(jni::alias_ref<jni::JString> /* deviceId */, jni::alias_ref<JFunc_void_bool_std__string::javaobject> /* callback */)>("discoverServices_cxx");
     method(_javaPart, jni::make_jstring(deviceId), JFunc_void_bool_std__string_cxx::fromCpp(callback));
   }
+  void JHybridNativeBleNitroSpec::discoverServicesWithCharacteristics(const std::string& deviceId, const std::function<void(bool /* success */, const std::string& /* error */)>& callback) {
+    static const auto method = _javaPart->javaClassStatic()->getMethod<void(jni::alias_ref<jni::JString> /* deviceId */, jni::alias_ref<JFunc_void_bool_std__string::javaobject> /* callback */)>("discoverServicesWithCharacteristics_cxx");
+    method(_javaPart, jni::make_jstring(deviceId), JFunc_void_bool_std__string_cxx::fromCpp(callback));
+  }
   std::vector<std::string> JHybridNativeBleNitroSpec::getServices(const std::string& deviceId) {
     static const auto method = _javaPart->javaClassStatic()->getMethod<jni::local_ref<jni::JArrayClass<jni::JString>>(jni::alias_ref<jni::JString> /* deviceId */)>("getServices");
     auto __result = method(_javaPart, jni::make_jstring(deviceId));
@@ -217,6 +221,11 @@ namespace margelo::nitro::co::zyke::ble {
     static const auto method = _javaPart->javaClassStatic()->getMethod<void(jni::alias_ref<jni::JString> /* deviceId */, jni::alias_ref<jni::JString> /* serviceId */, jni::alias_ref<jni::JString> /* characteristicId */, jni::alias_ref<JFunc_void_bool_std__string::javaobject> /* callback */)>("unsubscribeFromCharacteristic_cxx");
     method(_javaPart, jni::make_jstring(deviceId), jni::make_jstring(serviceId), jni::make_jstring(characteristicId), JFunc_void_bool_std__string_cxx::fromCpp(callback));
   }
+  bool JHybridNativeBleNitroSpec::isSubscribedToCharacteristic(const std::string& deviceId, const std::string& serviceId, const std::string& characteristicId) {
+    static const auto method = _javaPart->javaClassStatic()->getMethod<jboolean(jni::alias_ref<jni::JString> /* deviceId */, jni::alias_ref<jni::JString> /* serviceId */, jni::alias_ref<jni::JString> /* characteristicId */)>("isSubscribedToCharacteristic");
+    auto __result = method(_javaPart, jni::make_jstring(deviceId), jni::make_jstring(serviceId), jni::make_jstring(characteristicId));
+    return static_cast<bool>(__result);
+  }
   void JHybridNativeBleNitroSpec::requestBluetoothEnable(const std::function<void(bool /* success */, const std::string& /* error */)>& callback) {
     static const auto method = _javaPart->javaClassStatic()->getMethod<void(jni::alias_ref<JFunc_void_bool_std__string::javaobject> /* callback */)>("requestBluetoothEnable_cxx");
     method(_javaPart, JFunc_void_bool_std__string_cxx::fromCpp(callback));

package/nitrogen/generated/android/c++/JHybridNativeBleNitroSpec.hpp

@@ -67,12 +67,14 @@ namespace margelo::nitro::co::zyke::ble {
     double requestMTU(const std::string& deviceId, double mtu) override;
     void readRSSI(const std::string& deviceId, const std::function<void(bool /* success */, double /* rssi */, const std::string& /* error */)>& callback) override;
     void discoverServices(const std::string& deviceId, const std::function<void(bool /* success */, const std::string& /* error */)>& callback) override;
+    void discoverServicesWithCharacteristics(const std::string& deviceId, const std::function<void(bool /* success */, const std::string& /* error */)>& callback) override;
     std::vector<std::string> getServices(const std::string& deviceId) override;
     std::vector<std::string> getCharacteristics(const std::string& deviceId, const std::string& serviceId) override;
     void readCharacteristic(const std::string& deviceId, const std::string& serviceId, const std::string& characteristicId, const std::function<void(bool /* success */, const std::shared_ptr<ArrayBuffer>& /* data */, const std::string& /* error */)>& callback) override;
     void writeCharacteristic(const std::string& deviceId, const std::string& serviceId, const std::string& characteristicId, const std::shared_ptr<ArrayBuffer>& data, bool withResponse, const std::function<void(bool /* success */, const std::shared_ptr<ArrayBuffer>& /* responseData */, const std::string& /* error */)>& callback) override;
     void subscribeToCharacteristic(const std::string& deviceId, const std::string& serviceId, const std::string& characteristicId, const std::function<void(const std::string& /* characteristicId */, const std::shared_ptr<ArrayBuffer>& /* data */)>& updateCallback, const std::function<void(bool /* success */, const std::string& /* error */)>& completionCallback) override;
     void unsubscribeFromCharacteristic(const std::string& deviceId, const std::string& serviceId, const std::string& characteristicId, const std::function<void(bool /* success */, const std::string& /* error */)>& callback) override;
+    bool isSubscribedToCharacteristic(const std::string& deviceId, const std::string& serviceId, const std::string& characteristicId) override;
     void requestBluetoothEnable(const std::function<void(bool /* success */, const std::string& /* error */)>& callback) override;
     BLEState state() override;
     OperationResult subscribeToStateChange(const std::function<void(BLEState /* state */)>& stateCallback) override;

package/nitrogen/generated/android/kotlin/com/margelo/nitro/co/zyke/ble/HybridNativeBleNitroSpec.kt

@@ -113,6 +113,15 @@ abstract class HybridNativeBleNitroSpec: HybridObject() {
     return __result
   }
   
+  abstract fun discoverServicesWithCharacteristics(deviceId: String, callback: (success: Boolean, error: String) -> Unit): Unit
+  
+  @DoNotStrip
+  @Keep
+  private fun discoverServicesWithCharacteristics_cxx(deviceId: String, callback: Func_void_bool_std__string): Unit {
+    val __result = discoverServicesWithCharacteristics(deviceId, callback)
+    return __result
+  }
+  
   @DoNotStrip
   @Keep
   abstract fun getServices(deviceId: String): Array<String>
@@ -157,6 +166,10 @@ abstract class HybridNativeBleNitroSpec: HybridObject() {
     return __result
   }
   
+  @DoNotStrip
+  @Keep
+  abstract fun isSubscribedToCharacteristic(deviceId: String, serviceId: String, characteristicId: String): Boolean
+  
   abstract fun requestBluetoothEnable(callback: (success: Boolean, error: String) -> Unit): Unit
   
   @DoNotStrip

package/nitrogen/generated/ios/c++/HybridNativeBleNitroSpecSwift.hpp

@@ -184,6 +184,12 @@ namespace margelo::nitro::co::zyke::ble {
         std::rethrow_exception(__result.error());
       }
     }
+    inline void discoverServicesWithCharacteristics(const std::string& deviceId, const std::function<void(bool /* success */, const std::string& /* error */)>& callback) override {
+      auto __result = _swiftPart.discoverServicesWithCharacteristics(deviceId, callback);
+      if (__result.hasError()) [[unlikely]] {
+        std::rethrow_exception(__result.error());
+      }
+    }
     inline std::vector<std::string> getServices(const std::string& deviceId) override {
       auto __result = _swiftPart.getServices(deviceId);
       if (__result.hasError()) [[unlikely]] {
@@ -224,6 +230,14 @@ namespace margelo::nitro::co::zyke::ble {
         std::rethrow_exception(__result.error());
       }
     }
+    inline bool isSubscribedToCharacteristic(const std::string& deviceId, const std::string& serviceId, const std::string& characteristicId) override {
+      auto __result = _swiftPart.isSubscribedToCharacteristic(deviceId, serviceId, characteristicId);
+      if (__result.hasError()) [[unlikely]] {
+        std::rethrow_exception(__result.error());
+      }
+      auto __value = std::move(__result.value());
+      return __value;
+    }
     inline void requestBluetoothEnable(const std::function<void(bool /* success */, const std::string& /* error */)>& callback) override {
       auto __result = _swiftPart.requestBluetoothEnable(callback);
       if (__result.hasError()) [[unlikely]] {

package/nitrogen/generated/ios/swift/HybridNativeBleNitroSpec.swift

@@ -25,12 +25,14 @@ public protocol HybridNativeBleNitroSpec_protocol: HybridObject {
   func requestMTU(deviceId: String, mtu: Double) throws -> Double
   func readRSSI(deviceId: String, callback: @escaping (_ success: Bool, _ rssi: Double, _ error: String) -> Void) throws -> Void
   func discoverServices(deviceId: String, callback: @escaping (_ success: Bool, _ error: String) -> Void) throws -> Void
+  func discoverServicesWithCharacteristics(deviceId: String, callback: @escaping (_ success: Bool, _ error: String) -> Void) throws -> Void
   func getServices(deviceId: String) throws -> [String]
   func getCharacteristics(deviceId: String, serviceId: String) throws -> [String]
   func readCharacteristic(deviceId: String, serviceId: String, characteristicId: String, callback: @escaping (_ success: Bool, _ data: ArrayBuffer, _ error: String) -> Void) throws -> Void
   func writeCharacteristic(deviceId: String, serviceId: String, characteristicId: String, data: ArrayBuffer, withResponse: Bool, callback: @escaping (_ success: Bool, _ responseData: ArrayBuffer, _ error: String) -> Void) throws -> Void
   func subscribeToCharacteristic(deviceId: String, serviceId: String, characteristicId: String, updateCallback: @escaping (_ characteristicId: String, _ data: ArrayBuffer) -> Void, completionCallback: @escaping (_ success: Bool, _ error: String) -> Void) throws -> Void
   func unsubscribeFromCharacteristic(deviceId: String, serviceId: String, characteristicId: String, callback: @escaping (_ success: Bool, _ error: String) -> Void) throws -> Void
+  func isSubscribedToCharacteristic(deviceId: String, serviceId: String, characteristicId: String) throws -> Bool
   func requestBluetoothEnable(callback: @escaping (_ success: Bool, _ error: String) -> Void) throws -> Void
   func state() throws -> BLEState
   func subscribeToStateChange(stateCallback: @escaping (_ state: BLEState) -> Void) throws -> OperationResult

package/nitrogen/generated/ios/swift/HybridNativeBleNitroSpec_cxx.swift

@@ -370,6 +370,22 @@ open class HybridNativeBleNitroSpec_cxx {
     }
   }
   
+  @inline(__always)
+  public final func discoverServicesWithCharacteristics(deviceId: std.string, callback: bridge.Func_void_bool_std__string) -> bridge.Result_void_ {
+    do {
+      try self.__implementation.discoverServicesWithCharacteristics(deviceId: String(deviceId), callback: { () -> (Bool, String) -> Void in
+        let __wrappedFunction = bridge.wrap_Func_void_bool_std__string(callback)
+        return { (__success: Bool, __error: String) -> Void in
+          __wrappedFunction.call(__success, std.string(__error))
+        }
+      }())
+      return bridge.create_Result_void_()
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_void_(__exceptionPtr)
+    }
+  }
+  
   @inline(__always)
   public final func getServices(deviceId: std.string) -> bridge.Result_std__vector_std__string__ {
     do {
@@ -475,6 +491,18 @@ open class HybridNativeBleNitroSpec_cxx {
     }
   }
   
+  @inline(__always)
+  public final func isSubscribedToCharacteristic(deviceId: std.string, serviceId: std.string, characteristicId: std.string) -> bridge.Result_bool_ {
+    do {
+      let __result = try self.__implementation.isSubscribedToCharacteristic(deviceId: String(deviceId), serviceId: String(serviceId), characteristicId: String(characteristicId))
+      let __resultCpp = __result
+      return bridge.create_Result_bool_(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_bool_(__exceptionPtr)
+    }
+  }
+  
   @inline(__always)
   public final func requestBluetoothEnable(callback: bridge.Func_void_bool_std__string) -> bridge.Result_void_ {
     do {

package/nitrogen/generated/shared/c++/HybridNativeBleNitroSpec.cpp

@@ -28,12 +28,14 @@ namespace margelo::nitro::co::zyke::ble {
       prototype.registerHybridMethod("requestMTU", &HybridNativeBleNitroSpec::requestMTU);
       prototype.registerHybridMethod("readRSSI", &HybridNativeBleNitroSpec::readRSSI);
       prototype.registerHybridMethod("discoverServices", &HybridNativeBleNitroSpec::discoverServices);
+      prototype.registerHybridMethod("discoverServicesWithCharacteristics", &HybridNativeBleNitroSpec::discoverServicesWithCharacteristics);
       prototype.registerHybridMethod("getServices", &HybridNativeBleNitroSpec::getServices);
       prototype.registerHybridMethod("getCharacteristics", &HybridNativeBleNitroSpec::getCharacteristics);
       prototype.registerHybridMethod("readCharacteristic", &HybridNativeBleNitroSpec::readCharacteristic);
       prototype.registerHybridMethod("writeCharacteristic", &HybridNativeBleNitroSpec::writeCharacteristic);
       prototype.registerHybridMethod("subscribeToCharacteristic", &HybridNativeBleNitroSpec::subscribeToCharacteristic);
       prototype.registerHybridMethod("unsubscribeFromCharacteristic", &HybridNativeBleNitroSpec::unsubscribeFromCharacteristic);
+      prototype.registerHybridMethod("isSubscribedToCharacteristic", &HybridNativeBleNitroSpec::isSubscribedToCharacteristic);
       prototype.registerHybridMethod("requestBluetoothEnable", &HybridNativeBleNitroSpec::requestBluetoothEnable);
       prototype.registerHybridMethod("state", &HybridNativeBleNitroSpec::state);
       prototype.registerHybridMethod("subscribeToStateChange", &HybridNativeBleNitroSpec::subscribeToStateChange);

package/nitrogen/generated/shared/c++/HybridNativeBleNitroSpec.hpp

@@ -79,12 +79,14 @@ namespace margelo::nitro::co::zyke::ble {
       virtual double requestMTU(const std::string& deviceId, double mtu) = 0;
       virtual void readRSSI(const std::string& deviceId, const std::function<void(bool /* success */, double /* rssi */, const std::string& /* error */)>& callback) = 0;
       virtual void discoverServices(const std::string& deviceId, const std::function<void(bool /* success */, const std::string& /* error */)>& callback) = 0;
+      virtual void discoverServicesWithCharacteristics(const std::string& deviceId, const std::function<void(bool /* success */, const std::string& /* error */)>& callback) = 0;
       virtual std::vector<std::string> getServices(const std::string& deviceId) = 0;
       virtual std::vector<std::string> getCharacteristics(const std::string& deviceId, const std::string& serviceId) = 0;
       virtual void readCharacteristic(const std::string& deviceId, const std::string& serviceId, const std::string& characteristicId, const std::function<void(bool /* success */, const std::shared_ptr<ArrayBuffer>& /* data */, const std::string& /* error */)>& callback) = 0;
       virtual void writeCharacteristic(const std::string& deviceId, const std::string& serviceId, const std::string& characteristicId, const std::shared_ptr<ArrayBuffer>& data, bool withResponse, const std::function<void(bool /* success */, const std::shared_ptr<ArrayBuffer>& /* responseData */, const std::string& /* error */)>& callback) = 0;
       virtual void subscribeToCharacteristic(const std::string& deviceId, const std::string& serviceId, const std::string& characteristicId, const std::function<void(const std::string& /* characteristicId */, const std::shared_ptr<ArrayBuffer>& /* data */)>& updateCallback, const std::function<void(bool /* success */, const std::string& /* error */)>& completionCallback) = 0;
       virtual void unsubscribeFromCharacteristic(const std::string& deviceId, const std::string& serviceId, const std::string& characteristicId, const std::function<void(bool /* success */, const std::string& /* error */)>& callback) = 0;
+      virtual bool isSubscribedToCharacteristic(const std::string& deviceId, const std::string& serviceId, const std::string& characteristicId) = 0;
       virtual void requestBluetoothEnable(const std::function<void(bool /* success */, const std::string& /* error */)>& callback) = 0;
       virtual BLEState state() = 0;
       virtual OperationResult subscribeToStateChange(const std::function<void(BLEState /* state */)>& stateCallback) = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-ble-nitro",
-  "version": "1.11.0",
+  "version": "1.12.0",
   "description": "High-performance React Native BLE library built on Nitro Modules",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

package/src/__tests__/index.test.ts

@@ -10,12 +10,14 @@ const mockNativeInstance = {
   requestMTU: jest.fn(),
   readRSSI: jest.fn(),
   discoverServices: jest.fn(),
+  discoverServicesWithCharacteristics: jest.fn(),
   getServices: jest.fn(),
   getCharacteristics: jest.fn(),
   readCharacteristic: jest.fn(),
   writeCharacteristic: jest.fn(),
   subscribeToCharacteristic: jest.fn(),
   unsubscribeFromCharacteristic: jest.fn(),
+  isSubscribedToCharacteristic: jest.fn(),
   getConnectedDevices: jest.fn(),
   requestBluetoothEnable: jest.fn(),
   state: jest.fn(),
@@ -200,6 +202,90 @@ describe('BleNitro', () => {
     expect(result).toEqual([0xAA, 0xBB, 0xCC]); // Response data as ByteArray
   });
 
+  test('getServicesWithCharacteristics discovers and returns services with characteristics', async () => {
+    // First connect
+    mockNative.connect.mockImplementation((id: string, callback: (success: boolean, deviceId: string, error: string) => void, _disconnectCallback?: (deviceId: string, interrupted: boolean, error: string) => void) => {
+      callback(true, id, '');
+    });
+    await BleManager.connect('device-svc');
+
+    mockNative.isConnected.mockImplementation((id: string) => {
+      return id === 'device-svc';
+    });
+
+    // Mock discoverServicesWithCharacteristics
+    mockNative.discoverServicesWithCharacteristics.mockImplementation((_deviceId: string, callback: (success: boolean, error: string) => void) => {
+      callback(true, '');
+    });
+
+    // Mock getServices to return service UUIDs
+    mockNative.getServices.mockReturnValue(['0000180a-0000-1000-8000-00805f9b34fb', '0000180f-0000-1000-8000-00805f9b34fb']);
+
+    // Mock getCharacteristics per service
+    mockNative.getCharacteristics.mockImplementation((_deviceId: string, serviceId: string) => {
+      if (serviceId === '0000180a-0000-1000-8000-00805f9b34fb') {
+        return ['00002a29-0000-1000-8000-00805f9b34fb'];
+      }
+      return ['00002a19-0000-1000-8000-00805f9b34fb'];
+    });
+
+    const result = await BleManager.getServicesWithCharacteristics('device-svc');
+
+    expect(mockNative.discoverServicesWithCharacteristics).toHaveBeenCalledWith(
+      'device-svc',
+      expect.any(Function)
+    );
+    expect(result).toHaveLength(2);
+    expect(result[0]).toHaveProperty('uuid');
+    expect(result[0]).toHaveProperty('characteristics');
+    expect(result[0].characteristics.length).toBeGreaterThan(0);
+  });
+
+  test('getServicesWithCharacteristics rejects on discovery failure', async () => {
+    mockNative.connect.mockImplementation((id: string, callback: (success: boolean, deviceId: string, error: string) => void, _disconnectCallback?: (deviceId: string, interrupted: boolean, error: string) => void) => {
+      callback(true, id, '');
+    });
+    await BleManager.connect('device-svc-fail');
+
+    mockNative.isConnected.mockImplementation((id: string) => {
+      return id === 'device-svc-fail';
+    });
+
+    mockNative.discoverServicesWithCharacteristics.mockImplementation((_deviceId: string, callback: (success: boolean, error: string) => void) => {
+      callback(false, 'Discovery failed');
+    });
+
+    await expect(BleManager.getServicesWithCharacteristics('device-svc-fail')).rejects.toThrow('Discovery failed');
+  });
+
+  test('getServicesWithCharacteristics rejects when not connected', async () => {
+    mockNative.isConnected.mockReturnValue(false);
+
+    await expect(BleManager.getServicesWithCharacteristics('unknown-device')).rejects.toThrow('Device not connected');
+  });
+
+  test('getServicesWithCharacteristics rejects with BleTimeoutError on timeout', async () => {
+    jest.useFakeTimers();
+
+    mockNative.connect.mockImplementation((id: string, callback: (success: boolean, deviceId: string, error: string) => void) => {
+      callback(true, id, '');
+    });
+    await BleManager.connect('device-timeout');
+
+    mockNative.isConnected.mockImplementation((id: string) => id === 'device-timeout');
+
+    // Mock that NEVER calls its callback — simulates hung native discovery
+    mockNative.discoverServicesWithCharacteristics.mockImplementation(() => {});
+
+    const promise = BleManager.getServicesWithCharacteristics('device-timeout');
+
+    jest.advanceTimersByTime(30_000);
+
+    await expect(promise).rejects.toThrow('timed out after 30000ms');
+
+    jest.useRealTimers();
+  });
+
   test('readCharacteristic works after connection', async () => {
     // First connect
     mockNative.connect.mockImplementation((id: string, callback: (success: boolean, deviceId: string, error: string) => void, _disconnectCallback?: (deviceId: string, interrupted: boolean, error: string) => void) => {
@@ -304,6 +390,47 @@ describe('BleNitro', () => {
     expect(onDisconnect).toHaveBeenCalledWith(deviceId, true, 'Connection lost');
   });
 
+  test('isSubscribedToCharacteristic delegates to native with normalized UUIDs', () => {
+    mockNative.isSubscribedToCharacteristic.mockReturnValueOnce(true);
+
+    const result = BleManager.isSubscribedToCharacteristic('device', 'service', 'char');
+
+    expect(result).toBe(true);
+    expect(mockNative.isSubscribedToCharacteristic).toHaveBeenCalledWith(
+      'device',
+      '0service-0000-1000-8000-00805f9b34fb',
+      '0000char-0000-1000-8000-00805f9b34fb'
+    );
+  });
+
+  test('isSubscribedToCharacteristic returns false when not subscribed', () => {
+    mockNative.isSubscribedToCharacteristic.mockReturnValueOnce(false);
+
+    const result = BleManager.isSubscribedToCharacteristic('device', 'service', 'char');
+
+    expect(result).toBe(false);
+  });
+
+  test('isSubscribedToCharacteristic delegates to native for unknown devices', () => {
+    // Native layer handles unknown/disconnected devices by returning false
+    mockNative.isSubscribedToCharacteristic.mockReturnValueOnce(false);
+
+    const result = BleManager.isSubscribedToCharacteristic('unknown-device', 'service', 'char');
+
+    expect(result).toBe(false);
+    expect(mockNative.isSubscribedToCharacteristic).toHaveBeenCalled();
+  });
+
+  test('isSubscribedToCharacteristic propagates native exception', () => {
+    mockNative.isSubscribedToCharacteristic.mockImplementationOnce(() => {
+      throw new Error('Native error');
+    });
+
+    expect(() =>
+      BleManager.isSubscribedToCharacteristic('device', 'service', 'char')
+    ).toThrow('Native error');
+  });
+
   test('readRSSI requires connected device', async () => {
     await expect(
       BleManager.readRSSI('device-not-connected')

package/src/index.ts

@@ -15,6 +15,7 @@ export {
   BLEState,
   AndroidScanMode,
   BleNitroManager,
+  BleTimeoutError,
 } from "./manager";
 
 export { BleNitro } from './singleton';