react-native-ble-nitro 1.4.1 → 1.6.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/manager.d.ts

@@ -72,17 +72,17 @@ export declare class BleNitroManager {
      * Start scanning for Bluetooth devices
      * @param filter Optional scan filter
      * @param callback Callback function called when a device is found
-     * @returns Promise resolving to success state
+     * @returns void
      */
     startScan(filter: ScanFilter | undefined, callback: ScanCallback, onError?: (error: string) => void): void;
     /**
      * Stop scanning for Bluetooth devices
-     * @returns Promise resolving to success state
+     * @returns void
      */
     stopScan(): void;
     /**
      * Check if currently scanning for devices
-     * @returns Promise resolving to scanning state
+     * @returns Boolean indicating if currently scanning
      */
     isScanning(): boolean;
     /**
@@ -95,9 +95,20 @@ export declare class BleNitroManager {
      * Connect to a Bluetooth device
      * @param deviceId ID of the device to connect to
      * @param onDisconnect Optional callback for disconnect events
-     * @returns Promise resolving when connected
+     * @returns Promise resolving deviceId when connected
      */
-    connect(deviceId: string, onDisconnect?: DisconnectEventCallback): Promise<string>;
+    connect(deviceId: string, onDisconnect?: DisconnectEventCallback, autoConnectAndroid?: boolean): Promise<string>;
+    /**
+     * Scans for a device and connects to it
+     * @param deviceId ID of the device to connect to
+     * @param scanTimeout Optional timeout for the scan in milliseconds (default: 5000ms)
+     * @returns Promise resolving deviceId when connected
+     */
+    findAndConnect(deviceId: string, options?: {
+        scanTimeout?: number;
+        autoConnectAndroid?: boolean;
+        onDisconnect?: DisconnectEventCallback;
+    }): Promise<string>;
     /**
      * Disconnect from a Bluetooth device
      * @param deviceId ID of the device to disconnect from
@@ -107,7 +118,7 @@ export declare class BleNitroManager {
     /**
      * Check if connected to a device
      * @param deviceId ID of the device to check
-     * @returns Promise resolving to connection state
+     * @returns Boolean indicating if device is connected
      */
     isConnected(deviceId: string): boolean;
     /**
@@ -117,6 +128,12 @@ export declare class BleNitroManager {
      * @returns On Android: new MTU size; on iOS: current MTU size as it is handled by iOS itself; on error: -1
      */
     requestMTU(deviceId: string, mtu: number): number;
+    /**
+     * Read RSSI for a connected device
+     * @param deviceId ID of the device
+     * @returns Promise resolving to RSSI value
+     */
+    readRSSI(deviceId: string): Promise<number>;
     /**
      * Discover services for a connected device
      * @param deviceId ID of the device
@@ -133,15 +150,26 @@ export declare class BleNitroManager {
      * Get characteristics for a service
      * @param deviceId ID of the device
      * @param serviceId ID of the service
-     * @returns Promise resolving to array of characteristic UUIDs
+     * @returns array of characteristic UUIDs
      */
     getCharacteristics(deviceId: string, serviceId: string): string[];
+    /**
+     * Get services and characteristics for a connected device
+     * @param deviceId ID of the device
+     * @returns Promise resolving to array of service and characteristic UUIDs
+     * @see getServices
+     * @see getCharacteristics
+     */
+    getServicesWithCharacteristics(deviceId: string): Promise<{
+        uuid: string;
+        characteristics: string[];
+    }[]>;
     /**
      * Read a characteristic value
      * @param deviceId ID of the device
      * @param serviceId ID of the service
      * @param characteristicId ID of the characteristic
-     * @returns Promise resolving to the characteristic data as ArrayBuffer
+     * @returns Promise resolving to the characteristic data as ByteArray
      */
     readCharacteristic(deviceId: string, serviceId: string, characteristicId: string): Promise<ByteArray>;
     /**
@@ -160,7 +188,7 @@ export declare class BleNitroManager {
      * @param serviceId ID of the service
      * @param characteristicId ID of the characteristic
      * @param callback Callback function called when notification is received
-     * @returns Promise resolving when subscription is complete
+     * @returns Subscription
      */
     subscribeToCharacteristic(deviceId: string, serviceId: string, characteristicId: string, callback: CharacteristicUpdateCallback): Subscription;
     /**
@@ -173,7 +201,7 @@ export declare class BleNitroManager {
     unsubscribeFromCharacteristic(deviceId: string, serviceId: string, characteristicId: string): Promise<void>;
     /**
      * Check if Bluetooth is enabled
-     * @returns Promise resolving to Bluetooth state
+     * @returns returns Boolean according to Bluetooth state
      */
     isBluetoothEnabled(): boolean;
     /**
@@ -183,7 +211,7 @@ export declare class BleNitroManager {
     requestBluetoothEnable(): Promise<boolean>;
     /**
      * Get the current Bluetooth state
-     * @returns Promise resolving to Bluetooth state
+     * @returns Bluetooth state
      * @see BLEState
      */
     state(): BLEState;
@@ -191,7 +219,7 @@ export declare class BleNitroManager {
      * Subscribe to Bluetooth state changes
      * @param callback Callback function called when state changes
      * @param emitInitial Whether to emit initial state callback
-     * @returns Promise resolving when subscription is complete
+     * @returns Subscription
      * @see BLEState
      */
     subscribeToStateChange(callback: (state: BLEState) => void, emitInitial?: boolean): Subscription;

package/lib/manager.js

@@ -104,7 +104,7 @@ export class BleNitroManager {
      * Start scanning for Bluetooth devices
      * @param filter Optional scan filter
      * @param callback Callback function called when a device is found
-     * @returns Promise resolving to success state
+     * @returns void
      */
     startScan(filter = {}, callback, onError) {
         if (this._isScanning) {
@@ -135,7 +135,7 @@ export class BleNitroManager {
     }
     /**
      * Stop scanning for Bluetooth devices
-     * @returns Promise resolving to success state
+     * @returns void
      */
     stopScan() {
         if (!this._isScanning) {
@@ -146,7 +146,7 @@ export class BleNitroManager {
     }
     /**
      * Check if currently scanning for devices
-     * @returns Promise resolving to scanning state
+     * @returns Boolean indicating if currently scanning
      */
     isScanning() {
         this._isScanning = BleNitroNative.isScanning();
@@ -166,9 +166,9 @@ export class BleNitroManager {
      * Connect to a Bluetooth device
      * @param deviceId ID of the device to connect to
      * @param onDisconnect Optional callback for disconnect events
-     * @returns Promise resolving when connected
+     * @returns Promise resolving deviceId when connected
      */
-    connect(deviceId, onDisconnect) {
+    connect(deviceId, onDisconnect, autoConnectAndroid) {
         return new Promise((resolve, reject) => {
             // Check if already connected
             if (this._connectedDevices[deviceId]) {
@@ -187,7 +187,39 @@ export class BleNitroManager {
                 // Remove from connected devices when disconnected
                 delete this._connectedDevices[deviceId];
                 onDisconnect(deviceId, interrupted, error);
-            } : undefined);
+            } : undefined, autoConnectAndroid ?? false);
+        });
+    }
+    /**
+     * Scans for a device and connects to it
+     * @param deviceId ID of the device to connect to
+     * @param scanTimeout Optional timeout for the scan in milliseconds (default: 5000ms)
+     * @returns Promise resolving deviceId when connected
+     */
+    findAndConnect(deviceId, options) {
+        const isConnected = this.isConnected(deviceId);
+        if (isConnected) {
+            return Promise.resolve(deviceId);
+        }
+        if (this._isScanning) {
+            this.stopScan();
+        }
+        return new Promise((resolve, reject) => {
+            const timeoutScan = setTimeout(() => {
+                this.stopScan();
+                reject(new Error('Scan timed out'));
+            }, options?.scanTimeout ?? 5000);
+            this.startScan(undefined, (device) => {
+                if (device.id === deviceId) {
+                    this.stopScan();
+                    clearTimeout(timeoutScan);
+                    this.connect(deviceId, options?.onDisconnect, options?.autoConnectAndroid).then(async (connectedDeviceId) => {
+                        resolve(connectedDeviceId);
+                    }).catch((error) => {
+                        reject(error);
+                    });
+                }
+            });
         });
     }
     /**
@@ -216,7 +248,7 @@ export class BleNitroManager {
     /**
      * Check if connected to a device
      * @param deviceId ID of the device to check
-     * @returns Promise resolving to connection state
+     * @returns Boolean indicating if device is connected
      */
     isConnected(deviceId) {
         return BleNitroNative.isConnected(deviceId);
@@ -232,6 +264,28 @@ export class BleNitroManager {
         const deviceMtu = BleNitroNative.requestMTU(deviceId, mtu);
         return deviceMtu;
     }
+    /**
+     * Read RSSI for a connected device
+     * @param deviceId ID of the device
+     * @returns Promise resolving to RSSI value
+     */
+    readRSSI(deviceId) {
+        return new Promise((resolve, reject) => {
+            // Check if connected first
+            if (!this._connectedDevices[deviceId]) {
+                reject(new Error('Device not connected'));
+                return;
+            }
+            BleNitroNative.readRSSI(deviceId, (success, rssi, error) => {
+                if (success) {
+                    resolve(rssi);
+                }
+                else {
+                    reject(new Error(error));
+                }
+            });
+        });
+    }
     /**
      * Discover services for a connected device
      * @param deviceId ID of the device
@@ -279,7 +333,7 @@ export class BleNitroManager {
      * Get characteristics for a service
      * @param deviceId ID of the device
      * @param serviceId ID of the service
-     * @returns Promise resolving to array of characteristic UUIDs
+     * @returns array of characteristic UUIDs
      */
     getCharacteristics(deviceId, serviceId) {
         if (!this._connectedDevices[deviceId]) {
@@ -288,12 +342,29 @@ export class BleNitroManager {
         const characteristics = BleNitroNative.getCharacteristics(deviceId, BleNitroManager.normalizeGattUUID(serviceId));
         return BleNitroManager.normalizeGattUUIDs(characteristics);
     }
+    /**
+     * Get services and characteristics for a connected device
+     * @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),
+            };
+        });
+    }
     /**
      * Read a characteristic value
      * @param deviceId ID of the device
      * @param serviceId ID of the service
      * @param characteristicId ID of the characteristic
-     * @returns Promise resolving to the characteristic data as ArrayBuffer
+     * @returns Promise resolving to the characteristic data as ByteArray
      */
     readCharacteristic(deviceId, serviceId, characteristicId) {
         return new Promise((resolve, reject) => {
@@ -346,7 +417,7 @@ export class BleNitroManager {
      * @param serviceId ID of the service
      * @param characteristicId ID of the characteristic
      * @param callback Callback function called when notification is received
-     * @returns Promise resolving when subscription is complete
+     * @returns Subscription
      */
     subscribeToCharacteristic(deviceId, serviceId, characteristicId, callback) {
         // Check if connected first
@@ -397,7 +468,7 @@ export class BleNitroManager {
     }
     /**
      * Check if Bluetooth is enabled
-     * @returns Promise resolving to Bluetooth state
+     * @returns returns Boolean according to Bluetooth state
      */
     isBluetoothEnabled() {
         return this.state() === BLEState.PoweredOn;
@@ -420,7 +491,7 @@ export class BleNitroManager {
     }
     /**
      * Get the current Bluetooth state
-     * @returns Promise resolving to Bluetooth state
+     * @returns Bluetooth state
      * @see BLEState
      */
     state() {
@@ -430,7 +501,7 @@ export class BleNitroManager {
      * Subscribe to Bluetooth state changes
      * @param callback Callback function called when state changes
      * @param emitInitial Whether to emit initial state callback
-     * @returns Promise resolving when subscription is complete
+     * @returns Subscription
      * @see BLEState
      */
     subscribeToStateChange(callback, emitInitial = false) {

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

@@ -46,6 +46,7 @@ export type BooleanCallback = (result: boolean) => void;
 export type StringArrayCallback = (result: string[]) => void;
 export type ReadCharacteristicCallback = (success: boolean, data: BLEValue, error: string) => void;
 export type WriteCharacteristicCallback = (success: boolean, responseData: BLEValue, error: string) => void;
+export type ReadRSSICallback = (success: boolean, rssi: number, error: string) => void;
 export type RestoreCallback = (restoredPeripherals: BLEDevice[]) => void;
 export type OperationResult = {
     success: boolean;
@@ -64,10 +65,11 @@ export interface NativeBleNitro extends HybridObject<{
     stopScan(): boolean;
     isScanning(): boolean;
     getConnectedDevices(services: string[]): BLEDevice[];
-    connect(deviceId: string, callback: ConnectionCallback, disconnectCallback?: DisconnectionEventCallback): void;
+    connect(deviceId: string, callback: ConnectionCallback, disconnectCallback?: DisconnectionEventCallback, autoConnectAndroid?: boolean): void;
     disconnect(deviceId: string, callback: OperationCallback): void;
     isConnected(deviceId: string): boolean;
     requestMTU(deviceId: string, mtu: number): number;
+    readRSSI(deviceId: string, callback: ReadRSSICallback): void;
     discoverServices(deviceId: string, callback: OperationCallback): void;
     getServices(deviceId: string): string[];
     getCharacteristics(deviceId: string, serviceId: string): string[];

package/nitrogen/generated/android/BleNitroOnLoad.cpp

@@ -21,6 +21,7 @@
 #include "JFunc_void_bool_std__string_std__string.hpp"
 #include "JFunc_void_std__string_bool_std__string.hpp"
 #include "JFunc_void_bool_std__string.hpp"
+#include "JFunc_void_bool_double_std__string.hpp"
 #include "JFunc_void_bool_std__shared_ptr_ArrayBuffer__std__string.hpp"
 #include "JFunc_void_std__string_std__shared_ptr_ArrayBuffer_.hpp"
 #include "JFunc_void_BLEState.hpp"
@@ -41,6 +42,7 @@ int initialize(JavaVM* vm) {
     margelo::nitro::co::zyke::ble::JFunc_void_bool_std__string_std__string_cxx::registerNatives();
     margelo::nitro::co::zyke::ble::JFunc_void_std__string_bool_std__string_cxx::registerNatives();
     margelo::nitro::co::zyke::ble::JFunc_void_bool_std__string_cxx::registerNatives();
+    margelo::nitro::co::zyke::ble::JFunc_void_bool_double_std__string_cxx::registerNatives();
     margelo::nitro::co::zyke::ble::JFunc_void_bool_std__shared_ptr_ArrayBuffer__std__string_cxx::registerNatives();
     margelo::nitro::co::zyke::ble::JFunc_void_std__string_std__shared_ptr_ArrayBuffer__cxx::registerNatives();
     margelo::nitro::co::zyke::ble::JFunc_void_BLEState_cxx::registerNatives();

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

@@ -0,0 +1,75 @@
+///
+/// JFunc_void_bool_double_std__string.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#include <fbjni/fbjni.h>
+#include <functional>
+
+#include <string>
+#include <functional>
+
+namespace margelo::nitro::co::zyke::ble {
+
+  using namespace facebook;
+
+  /**
+   * Represents the Java/Kotlin callback `(success: Boolean, rssi: Double, error: String) -> Unit`.
+   * This can be passed around between C++ and Java/Kotlin.
+   */
+  struct JFunc_void_bool_double_std__string: public jni::JavaClass<JFunc_void_bool_double_std__string> {
+  public:
+    static auto constexpr kJavaDescriptor = "Lcom/margelo/nitro/co/zyke/ble/Func_void_bool_double_std__string;";
+
+  public:
+    /**
+     * Invokes the function this `JFunc_void_bool_double_std__string` instance holds through JNI.
+     */
+    void invoke(bool success, double rssi, const std::string& error) const {
+      static const auto method = javaClassStatic()->getMethod<void(jboolean /* success */, double /* rssi */, jni::alias_ref<jni::JString> /* error */)>("invoke");
+      method(self(), success, rssi, jni::make_jstring(error));
+    }
+  };
+
+  /**
+   * An implementation of Func_void_bool_double_std__string that is backed by a C++ implementation (using `std::function<...>`)
+   */
+  struct JFunc_void_bool_double_std__string_cxx final: public jni::HybridClass<JFunc_void_bool_double_std__string_cxx, JFunc_void_bool_double_std__string> {
+  public:
+    static jni::local_ref<JFunc_void_bool_double_std__string::javaobject> fromCpp(const std::function<void(bool /* success */, double /* rssi */, const std::string& /* error */)>& func) {
+      return JFunc_void_bool_double_std__string_cxx::newObjectCxxArgs(func);
+    }
+
+  public:
+    /**
+     * Invokes the C++ `std::function<...>` this `JFunc_void_bool_double_std__string_cxx` instance holds.
+     */
+    void invoke_cxx(jboolean success, double rssi, jni::alias_ref<jni::JString> error) {
+      _func(static_cast<bool>(success), rssi, error->toStdString());
+    }
+
+  public:
+    [[nodiscard]]
+    inline const std::function<void(bool /* success */, double /* rssi */, const std::string& /* error */)>& getFunction() const {
+      return _func;
+    }
+
+  public:
+    static auto constexpr kJavaDescriptor = "Lcom/margelo/nitro/co/zyke/ble/Func_void_bool_double_std__string_cxx;";
+    static void registerNatives() {
+      registerHybrid({makeNativeMethod("invoke_cxx", JFunc_void_bool_double_std__string_cxx::invoke_cxx)});
+    }
+
+  private:
+    explicit JFunc_void_bool_double_std__string_cxx(const std::function<void(bool /* success */, double /* rssi */, const std::string& /* error */)>& func): _func(func) { }
+
+  private:
+    friend HybridBase;
+    std::function<void(bool /* success */, double /* rssi */, const std::string& /* error */)> _func;
+  };
+
+} // namespace margelo::nitro::co::zyke::ble

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

@@ -52,6 +52,7 @@ namespace margelo::nitro::co::zyke::ble { enum class AndroidScanMode; }
 #include "JFunc_void_bool_std__string_std__string.hpp"
 #include "JFunc_void_std__string_bool_std__string.hpp"
 #include "JFunc_void_bool_std__string.hpp"
+#include "JFunc_void_bool_double_std__string.hpp"
 #include "JFunc_void_bool_std__shared_ptr_ArrayBuffer__std__string.hpp"
 #include "JFunc_void_std__string_std__shared_ptr_ArrayBuffer_.hpp"
 #include "JFunc_void_BLEState.hpp"
@@ -122,9 +123,9 @@ namespace margelo::nitro::co::zyke::ble {
       return __vector;
     }();
   }
-  void JHybridNativeBleNitroSpec::connect(const std::string& deviceId, const std::function<void(bool /* success */, const std::string& /* deviceId */, const std::string& /* error */)>& callback, const std::optional<std::function<void(const std::string& /* deviceId */, bool /* interrupted */, const std::string& /* error */)>>& disconnectCallback) {
-    static const auto method = javaClassStatic()->getMethod<void(jni::alias_ref<jni::JString> /* deviceId */, jni::alias_ref<JFunc_void_bool_std__string_std__string::javaobject> /* callback */, jni::alias_ref<JFunc_void_std__string_bool_std__string::javaobject> /* disconnectCallback */)>("connect_cxx");
-    method(_javaPart, jni::make_jstring(deviceId), JFunc_void_bool_std__string_std__string_cxx::fromCpp(callback), disconnectCallback.has_value() ? JFunc_void_std__string_bool_std__string_cxx::fromCpp(disconnectCallback.value()) : nullptr);
+  void JHybridNativeBleNitroSpec::connect(const std::string& deviceId, const std::function<void(bool /* success */, const std::string& /* deviceId */, const std::string& /* error */)>& callback, const std::optional<std::function<void(const std::string& /* deviceId */, bool /* interrupted */, const std::string& /* error */)>>& disconnectCallback, std::optional<bool> autoConnectAndroid) {
+    static const auto method = javaClassStatic()->getMethod<void(jni::alias_ref<jni::JString> /* deviceId */, jni::alias_ref<JFunc_void_bool_std__string_std__string::javaobject> /* callback */, jni::alias_ref<JFunc_void_std__string_bool_std__string::javaobject> /* disconnectCallback */, jni::alias_ref<jni::JBoolean> /* autoConnectAndroid */)>("connect_cxx");
+    method(_javaPart, jni::make_jstring(deviceId), JFunc_void_bool_std__string_std__string_cxx::fromCpp(callback), disconnectCallback.has_value() ? JFunc_void_std__string_bool_std__string_cxx::fromCpp(disconnectCallback.value()) : nullptr, autoConnectAndroid.has_value() ? jni::JBoolean::valueOf(autoConnectAndroid.value()) : nullptr);
   }
   void JHybridNativeBleNitroSpec::disconnect(const std::string& deviceId, const std::function<void(bool /* success */, const std::string& /* error */)>& callback) {
     static const auto method = javaClassStatic()->getMethod<void(jni::alias_ref<jni::JString> /* deviceId */, jni::alias_ref<JFunc_void_bool_std__string::javaobject> /* callback */)>("disconnect_cxx");
@@ -140,6 +141,10 @@ namespace margelo::nitro::co::zyke::ble {
     auto __result = method(_javaPart, jni::make_jstring(deviceId), mtu);
     return __result;
   }
+  void JHybridNativeBleNitroSpec::readRSSI(const std::string& deviceId, const std::function<void(bool /* success */, double /* rssi */, const std::string& /* error */)>& callback) {
+    static const auto method = javaClassStatic()->getMethod<void(jni::alias_ref<jni::JString> /* deviceId */, jni::alias_ref<JFunc_void_bool_double_std__string::javaobject> /* callback */)>("readRSSI_cxx");
+    method(_javaPart, jni::make_jstring(deviceId), JFunc_void_bool_double_std__string_cxx::fromCpp(callback));
+  }
   void JHybridNativeBleNitroSpec::discoverServices(const std::string& deviceId, const std::function<void(bool /* success */, const std::string& /* error */)>& callback) {
     static const auto method = 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));

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

@@ -58,10 +58,11 @@ namespace margelo::nitro::co::zyke::ble {
     bool stopScan() override;
     bool isScanning() override;
     std::vector<BLEDevice> getConnectedDevices(const std::vector<std::string>& services) override;
-    void connect(const std::string& deviceId, const std::function<void(bool /* success */, const std::string& /* deviceId */, const std::string& /* error */)>& callback, const std::optional<std::function<void(const std::string& /* deviceId */, bool /* interrupted */, const std::string& /* error */)>>& disconnectCallback) override;
+    void connect(const std::string& deviceId, const std::function<void(bool /* success */, const std::string& /* deviceId */, const std::string& /* error */)>& callback, const std::optional<std::function<void(const std::string& /* deviceId */, bool /* interrupted */, const std::string& /* error */)>>& disconnectCallback, std::optional<bool> autoConnectAndroid) override;
     void disconnect(const std::string& deviceId, const std::function<void(bool /* success */, const std::string& /* error */)>& callback) override;
     bool isConnected(const std::string& deviceId) override;
     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;
     std::vector<std::string> getServices(const std::string& deviceId) override;
     std::vector<std::string> getCharacteristics(const std::string& deviceId, const std::string& serviceId) override;

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

@@ -0,0 +1,81 @@
+///
+/// Func_void_bool_double_std__string.kt
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+package com.margelo.nitro.co.zyke.ble
+
+import androidx.annotation.Keep
+import com.facebook.jni.HybridData
+import com.facebook.proguard.annotations.DoNotStrip
+import com.margelo.nitro.core.*
+import dalvik.annotation.optimization.FastNative
+
+
+/**
+ * Represents the JavaScript callback `(success: boolean, rssi: number, error: string) => void`.
+ * This can be either implemented in C++ (in which case it might be a callback coming from JS),
+ * or in Kotlin/Java (in which case it is a native callback).
+ */
+@DoNotStrip
+@Keep
+@Suppress("ClassName", "RedundantUnitReturnType")
+fun interface Func_void_bool_double_std__string: (Boolean, Double, String) -> Unit {
+  /**
+   * Call the given JS callback.
+   * @throws Throwable if the JS function itself throws an error, or if the JS function/runtime has already been deleted.
+   */
+  @DoNotStrip
+  @Keep
+  override fun invoke(success: Boolean, rssi: Double, error: String): Unit
+}
+
+/**
+ * Represents the JavaScript callback `(success: boolean, rssi: number, error: string) => void`.
+ * This is implemented in C++, via a `std::function<...>`.
+ * The callback might be coming from JS.
+ */
+@DoNotStrip
+@Keep
+@Suppress(
+  "KotlinJniMissingFunction", "unused",
+  "RedundantSuppression", "RedundantUnitReturnType", "FunctionName",
+  "ConvertSecondaryConstructorToPrimary", "ClassName", "LocalVariableName",
+)
+class Func_void_bool_double_std__string_cxx: Func_void_bool_double_std__string {
+  @DoNotStrip
+  @Keep
+  private val mHybridData: HybridData
+
+  @DoNotStrip
+  @Keep
+  private constructor(hybridData: HybridData) {
+    mHybridData = hybridData
+  }
+
+  @DoNotStrip
+  @Keep
+  override fun invoke(success: Boolean, rssi: Double, error: String): Unit
+    = invoke_cxx(success,rssi,error)
+
+  @FastNative
+  private external fun invoke_cxx(success: Boolean, rssi: Double, error: String): Unit
+}
+
+/**
+ * Represents the JavaScript callback `(success: boolean, rssi: number, error: string) => void`.
+ * This is implemented in Java/Kotlin, via a `(Boolean, Double, String) -> Unit`.
+ * The callback is always coming from native.
+ */
+@DoNotStrip
+@Keep
+@Suppress("ClassName", "RedundantUnitReturnType", "unused")
+class Func_void_bool_double_std__string_java(private val function: (Boolean, Double, String) -> Unit): Func_void_bool_double_std__string {
+  @DoNotStrip
+  @Keep
+  override fun invoke(success: Boolean, rssi: Double, error: String): Unit {
+    return this.function(success, rssi, error)
+  }
+}

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

@@ -70,12 +70,12 @@ abstract class HybridNativeBleNitroSpec: HybridObject() {
   @Keep
   abstract fun getConnectedDevices(services: Array<String>): Array<BLEDevice>
   
-  abstract fun connect(deviceId: String, callback: (success: Boolean, deviceId: String, error: String) -> Unit, disconnectCallback: ((deviceId: String, interrupted: Boolean, error: String) -> Unit)?): Unit
+  abstract fun connect(deviceId: String, callback: (success: Boolean, deviceId: String, error: String) -> Unit, disconnectCallback: ((deviceId: String, interrupted: Boolean, error: String) -> Unit)?, autoConnectAndroid: Boolean?): Unit
   
   @DoNotStrip
   @Keep
-  private fun connect_cxx(deviceId: String, callback: Func_void_bool_std__string_std__string, disconnectCallback: Func_void_std__string_bool_std__string?): Unit {
-    val __result = connect(deviceId, callback, disconnectCallback?.let { it })
+  private fun connect_cxx(deviceId: String, callback: Func_void_bool_std__string_std__string, disconnectCallback: Func_void_std__string_bool_std__string?, autoConnectAndroid: Boolean?): Unit {
+    val __result = connect(deviceId, callback, disconnectCallback?.let { it }, autoConnectAndroid)
     return __result
   }
   
@@ -96,6 +96,15 @@ abstract class HybridNativeBleNitroSpec: HybridObject() {
   @Keep
   abstract fun requestMTU(deviceId: String, mtu: Double): Double
   
+  abstract fun readRSSI(deviceId: String, callback: (success: Boolean, rssi: Double, error: String) -> Unit): Unit
+  
+  @DoNotStrip
+  @Keep
+  private fun readRSSI_cxx(deviceId: String, callback: Func_void_bool_double_std__string): Unit {
+    val __result = readRSSI(deviceId, callback)
+    return __result
+  }
+  
   abstract fun discoverServices(deviceId: String, callback: (success: Boolean, error: String) -> Unit): Unit
   
   @DoNotStrip

package/nitrogen/generated/ios/BleNitro-Swift-Cxx-Bridge.cpp

@@ -53,6 +53,14 @@ namespace margelo::nitro::co::zyke::ble::bridge::swift {
     };
   }
   
+  // pragma MARK: std::function<void(bool /* success */, double /* rssi */, const std::string& /* error */)>
+  Func_void_bool_double_std__string create_Func_void_bool_double_std__string(void* _Nonnull swiftClosureWrapper) {
+    auto swiftClosure = BleNitro::Func_void_bool_double_std__string::fromUnsafe(swiftClosureWrapper);
+    return [swiftClosure = std::move(swiftClosure)](bool success, double rssi, const std::string& error) mutable -> void {
+      swiftClosure.call(success, rssi, error);
+    };
+  }
+  
   // pragma MARK: std::function<void(bool /* success */, const std::shared_ptr<ArrayBuffer>& /* data */, const std::string& /* error */)>
   Func_void_bool_std__shared_ptr_ArrayBuffer__std__string create_Func_void_bool_std__shared_ptr_ArrayBuffer__std__string(void* _Nonnull swiftClosureWrapper) {
     auto swiftClosure = BleNitro::Func_void_bool_std__shared_ptr_ArrayBuffer__std__string::fromUnsafe(swiftClosureWrapper);