Activity

1. LohenHM

   added

   bug

   on Sep 4, 2025
2. josmithua commented on Sep 16, 2025

   

   josmithua

   on Sep 16, 2025

   Contributor

   More actions

   Patch:

   react-native-ble-plx+3.5.0.patch

   diff --git a/node_modules/react-native-ble-plx/android/src/main/java/com/bleplx/BlePlxModule.java b/node_modules/react-native-ble-plx/android/src/main/java/com/bleplx/BlePlxModule.java
   index c731640..22b438d 100644
   --- a/node_modules/react-native-ble-plx/android/src/main/java/com/bleplx/BlePlxModule.java
   +++ b/node_modules/react-native-ble-plx/android/src/main/java/com/bleplx/BlePlxModule.java
   @@ -788,7 +788,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
          }, new OnErrorCallback() {
            @Override
            public void onError(BleError error) {
   -          safePromise.reject(null, errorConverter.toJs(error));
   +          safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
            }
          }
        );

   👍React with 👍1Reacted by Johhan Santana
3. karlvonladach commented on Sep 17, 2025

   

   karlvonladach

   on Sep 17, 2025

   More actions

   This is not the only line to fix. I'm for example using monitorCharacteristic() instead of monitorCharacteristicForDevice(), and it has the same issue.
   And actually, all the other functions in this file have the same issue. Once I had a writeCharacteristic() error (due to some malformatted data) and it also made the app crash, with the same error.
4. fatihkayan20 commented on Sep 17, 2025

   

   fatihkayan20

   on Sep 17, 2025

   More actions

   I'm having same issue after upgrading my project to expo 54. I'm using "monitorCharacteristicForService" function.

   ERROR Your app just crashed. See the error below.
   java.lang.NullPointerException: Parameter specified as non-null is null: method com.facebook.react.bridge.PromiseImpl.reject, parameter code
   com.facebook.react.bridge.PromiseImpl.reject(Unknown Source:2)
   com.bleplx.utils.SafePromise.reject(SafePromise.java:25)
   com.bleplx.BlePlxModule$41.onError(BlePlxModule.java:791)
   com.bleplx.adapter.utils.SafeExecutor.error(SafeExecutor.java:30)
   com.bleplx.adapter.BleModule.lambda$safeMonitorCharacteristicForDevice$42(BleModule.java:1476)
   com.bleplx.adapter.BleModule.$r8$lambda$oguGTpV4M2u9BE2h87wB5iwi2-M(Unknown Source:0)
   com.bleplx.adapter.BleModule$$ExternalSyntheticLambda47.run(D8$$SyntheticClass:0)
   io.reactivex.internal.operators.flowable.FlowableDoOnLifecycle$SubscriptionLambdaSubscriber.cancel(FlowableDoOnLifecycle.java:115)
   io.reactivex.internal.subscribers.BasicFuseableSubscriber.cancel(BasicFuseableSubscriber.java:158)
   io.reactivex.internal.subscriptions.SubscriptionHelper.cancel(SubscriptionHelper.java:181)
   io.reactivex.internal.subscribers.LambdaSubscriber.cancel(LambdaSubscriber.java:119)
   io.reactivex.internal.subscribers.LambdaSubscriber.dispose(LambdaSubscriber.java:104)
   com.bleplx.adapter.utils.DisposableMap.removeSubscription(DisposableMap.java:24)
   com.bleplx.adapter.BleModule.cancelTransaction(BleModule.java:1044)
   com.bleplx.BlePlxModule.cancelTransaction(BlePlxModule.java:134)
   com.facebook.jni.NativeRunnable.run(Native Method)
   android.os.Handler.handleCallback(Handler.java:942)
   android.os.Handler.dispatchMessage(Handler.java:99)
   com.facebook.react.bridge.queue.MessageQueueThreadHandler.dispatchMessage(MessageQueueThreadHandler.kt:21)
   android.os.Looper.loopOnce(Looper.java:201)
   android.os.Looper.loop(Looper.java:288)
   com.facebook.react.bridge.queue.MessageQueueThreadImpl$Companion.startNewBackgroundThread$lambda$1(MessageQueueThreadImpl.kt:175)
   com.facebook.react.bridge.queue.MessageQueueThreadImpl$Companion.$r8$lambda$ldnZnqelhYFctGaUKkOKYj5rxo4(Unknown Source:0)
   com.facebook.react.bridge.queue.MessageQueueThreadImpl$Companion$$ExternalSyntheticLambda0.run(D8$$SyntheticClass:0)
   java.lang.Thread.run(Thread.java:1119)

   👍React with 👍1Reacted by CHENG-WEI WENG
5. josmithua commented on Sep 17, 2025

   

   josmithua

   on Sep 17, 2025

   Contributor

   More actions

   I'm very thankful for this package and all the maintainers over the years, but I think it might be time to create a fork if it is going to remain unmaintained. At least I'd be interested in becoming a contributor to help get bug fixes in and released. Bluetooth connectivity is at the core of our work projects and we need a reliable solution that supports the new architecture.

   👍React with 👍10Reacted by Matt, Antoine Van Malleghem, Stumblor, Patrick Dench, David Bochan, Zach Hucker, Bjorn Swift, Nohj, Smaïl Hammour and g-otn
6. thenjneer commented on Oct 3, 2025

   

   thenjneer

   on Oct 3, 2025

   More actions

   react-native-ble-plx+3.5.0.patch

   For anyone having this issue, here's a working patch^

   And here's a writeup (courtesy of mr Claude) for how to use it. @aliberski @angelos3lex this fix is tested working if you plan on updating:

   `# Fix for react-native-ble-plx Android Crash on Disconnect

   Problem

   React Native apps using react-native-ble-plx crash on Android when BLE devices disconnect unexpectedly. This is caused by Promise.reject(null) calls in the native Android code, which crashes modern React Native versions that require non-null error codes.

   Affected versions:

   • react-native-ble-plx: 3.2.1, 3.5.0
   • React Native: 0.81.4+
   • Expo SDK: 54+

   Error symptoms:

   • App crashes during BLE device disconnect
   • Native crashes that bypass JavaScript error handling
   • Crashes occur specifically when using characteristic.monitor() operations

   Root Cause

   The issue is in BlePlxModule.java where 17 instances of error handling use:

   safePromise.reject(null, errorConverter.toJs(error));

   React Native's PromiseImpl.reject() requires non-null error codes, but the BLE library passes null during disconnect scenarios.

   GitHub References:

   • Issue: 🐛 Android: App crashes on device disconnect when using monitorCharacteristicForDevice() #1303
   • PR: Provide error code on promise rejections (fixes #1303) #1304

   Solution

   Use patch-package to fix the native Android code by replacing all null error codes with proper error code names.

   Step 1: Install patch-package

   npm install --save-dev patch-package

   Step 2: Add postinstall script

   Add this to your package.json:

   {
     "scripts": {
       "postinstall": "patch-package"
     }
   }

   Step 3: Create the patch file

   1. Create a patches directory in your project root
   2. Create patches/react-native-ble-plx+3.5.0.patch with the following content:

   diff --git a/node_modules/react-native-ble-plx/android/src/main/java/com/bleplx/BlePlxModule.java b/node_modules/react-native-ble-plx/android/src/main/java/com/bleplx/BlePlxModule.java
   index 1234567..abcdefg 100644
   --- a/node_modules/react-native-ble-plx/android/src/main/java/com/bleplx/BlePlxModule.java
   +++ b/node_modules/react-native-ble-plx/android/src/main/java/com/bleplx/BlePlxModule.java
   @@ -168,7 +168,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
        }, new OnErrorCallback() {
          @Override
          public void onError(BleError error) {
   -        safePromise.reject(null, errorConverter.toJs(error));
   +        safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
          }
        });
      }
   @@ -187,7 +187,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
        }, new OnErrorCallback() {
          @Override
          public void onError(BleError error) {
   -        safePromise.reject(null, errorConverter.toJs(error));
   +        safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
          }
        });
      }
   @@ -318,7 +318,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
          }, new OnErrorCallback() {
            @Override
            public void onError(BleError error) {
   -          safePromise.reject(null, errorConverter.toJs(error));
   +          safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
            }
          });
      }
   @@ -338,7 +338,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
          }, new OnErrorCallback() {
            @Override
            public void onError(BleError error) {
   -          safePromise.reject(null, errorConverter.toJs(error));
   +          safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
            }
          });
      }
   @@ -358,7 +358,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
          }, new OnErrorCallback() {
            @Override
            public void onError(BleError error) {
   -          safePromise.reject(null, errorConverter.toJs(error));
   +          safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
            }
          });
      }
   @@ -422,7 +422,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
          new OnErrorCallback() {
            @Override
            public void onError(BleError error) {
   -          safePromise.reject(null, errorConverter.toJs(error));
   +          safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
            }
          });
      }
   @@ -442,7 +442,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
          }, new OnErrorCallback() {
            @Override
            public void onError(BleError error) {
   -          safePromise.reject(null, errorConverter.toJs(error));
   +          safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
            }
          });
      }
   @@ -483,7 +483,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
          }, new OnErrorCallback() {
            @Override
            public void onError(BleError error) {
   -          safePromise.reject(null, errorConverter.toJs(error));
   +          safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
            }
          });
      }
   @@ -627,7 +627,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
          }, new OnErrorCallback() {
            @Override
            public void onError(BleError error) {
   -          safePromise.reject(null, errorConverter.toJs(error));
   +          safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
            }
          }
        );
   @@ -654,7 +654,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
          }, new OnErrorCallback() {
            @Override
            public void onError(BleError error) {
   -          safePromise.reject(null, errorConverter.toJs(error));
   +          safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
            }
          }
        );
   @@ -680,7 +680,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
          }, new OnErrorCallback() {
            @Override
            public void onError(BleError error) {
   -          safePromise.reject(null, errorConverter.toJs(error));
   +          safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
            }
          });
      }
   @@ -706,7 +706,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
          }, new OnErrorCallback() {
            @Override
            public void onError(BleError error) {
   -          safePromise.reject(null, errorConverter.toJs(error));
   +          safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
            }
          }
        );
   @@ -732,7 +732,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
          }, new OnErrorCallback() {
            @Override
            public void onError(BleError error) {
   -          safePromise.reject(null, errorConverter.toJs(error));
   +          safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
            }
          }
        );
   @@ -757,7 +757,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
          }, new OnErrorCallback() {
            @Override
            public void onError(BleError error) {
   -          safePromise.reject(null, errorConverter.toJs(error));
   +          safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
            }
          }
        );
   @@ -788,7 +788,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
          }, new OnErrorCallback() {
            @Override
            public void onError(BleError error) {
   -          safePromise.reject(null, errorConverter.toJs(error));
   +          safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
            }
          }
        );
   @@ -818,7 +818,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
          }, new OnErrorCallback() {
            @Override
            public void onError(BleError error) {
   -          safePromise.reject(null, errorConverter.toJs(error));
   +          safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
            }
          }
        );
   @@ -848,7 +848,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
          }, new OnErrorCallback() {
            @Override
            public void onError(BleError error) {
   -          safePromise.reject(null, errorConverter.toJs(error));
   +          safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
            }
          }
        );

   Step 4: Apply the patch

   # Apply the patch immediately
   npx patch-package
   
   # For Expo projects - rebuild native code (required for Android changes)
   npx expo prebuild --clean
   
   # For standard React Native projects
   npx react-native run-android

   How It Works

   Automatic Application

   The patch is automatically applied via the postinstall script:

   • Every npm install - Patch gets applied automatically
   • Every npm ci - Same automatic application
   • After dependency updates - Ensures the patch persists
   • On new team member setup - Automatically applies when they install dependencies

   What Gets Fixed

   The patch fixes 17 instances in BlePlxModule.java where:

   // BEFORE (causes crashes):
   safePromise.reject(null, errorConverter.toJs(error));
   
   // AFTER (fixed):
   safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));

   This affects all BLE monitoring operations:

   • characteristic.monitor() calls
   • Button press monitoring
   • Sensor data monitoring
   • Battery level monitoring
   • Distance/RSSI monitoring

   Verification

   Test the fix:

   1. Connect to a BLE device
   2. Start characteristic monitoring
   3. Manually disconnect the device (turn off, move out of range, etc.)
   4. App should handle disconnect gracefully without crashing

   Expected behavior:

   • ✅ No native crashes during disconnect
   • ✅ Clean disconnect handling
   • ✅ Proper error reporting with valid error codes
   • ✅ App continues to function normally

   Benefits

   1. Automatic - No manual intervention needed after setup
   2. Persistent - Survives dependency updates and team onboarding
   3. Version-controlled - The patch file is committed to your repo
   4. Reliable - Works consistently across different environments
   5. Minimal - Only fixes the specific issue without other modifications
   6. Production-ready - Safe for production use

   Compatibility

   • ✅ React Native 0.81.4+
   • ✅ Expo SDK 54+
   • ✅ react-native-ble-plx 3.2.1, 3.5.0
   • ✅ Android (primary fix)
   • ✅ iOS (no changes needed, works normally)

   This fix has been tested and verified to resolve BLE disconnect crashes in production React Native applications.
   `

   👍React with 👍6Reacted by kimchoky, Nohj, Luiz Eduardo, TRAN MINH DUC, Rajvansh Manav and jaivikdhebar

   ❤️React with ❤️29Reacted by Dom Cotterill, Tygo Egmond, KID, mrtomhoward, Pavel Potoček, Stefan Hynst, James Rogers, JorisM, Farhoud, Bertrand VERDUN and 19 more

   🚀React with 🚀3Reacted by Luiz Eduardo, Rajvansh Manav and jaivikdhebar
7. Mr-KID-github commented on Oct 9, 2025

   

   Mr-KID-github

   on Oct 9, 2025

   More actions

   react-native-ble-plx+3.5.0.patch

   For anyone having this issue, here's a working patch^

   And here's a writeup (courtesy of mr Claude) for how to use it. @aliberski @angelos3lex this fix is tested working if you plan on updating:

   `# Fix for react-native-ble-plx Android Crash on Disconnect

   Problem

   React Native apps using react-native-ble-plx crash on Android when BLE devices disconnect unexpectedly. This is caused by Promise.reject(null) calls in the native Android code, which crashes modern React Native versions that require non-null error codes.

   Affected versions:

   • react-native-ble-plx: 3.2.1, 3.5.0
   • React Native: 0.81.4+
   • Expo SDK: 54+

   Error symptoms:

   • App crashes during BLE device disconnect
   • Native crashes that bypass JavaScript error handling
   • Crashes occur specifically when using characteristic.monitor() operations

   Root Cause

   The issue is in BlePlxModule.java where 17 instances of error handling use:

   safePromise.reject(null, errorConverter.toJs(error));
   React Native's PromiseImpl.reject() requires non-null error codes, but the BLE library passes null during disconnect scenarios.

   GitHub References:

   • Issue: 🐛 Android: App crashes on device disconnect when using monitorCharacteristicForDevice() #1303
   • PR: Provide error code on promise rejections (fixes #1303) #1304

   Solution

   Use patch-package to fix the native Android code by replacing all null error codes with proper error code names.

   Step 1: Install patch-package

   npm install --save-dev patch-package

   Step 2: Add postinstall script

   Add this to your package.json:

   {
   "scripts": {
   "postinstall": "patch-package"
   }
   }

   Step 3: Create the patch file

   1. Create a patches directory in your project root
   2. Create patches/react-native-ble-plx+3.5.0.patch with the following content:

   diff --git a/node_modules/react-native-ble-plx/android/src/main/java/com/bleplx/BlePlxModule.java b/node_modules/react-native-ble-plx/android/src/main/java/com/bleplx/BlePlxModule.java
   index 1234567..abcdefg 100644
   --- a/node_modules/react-native-ble-plx/android/src/main/java/com/bleplx/BlePlxModule.java
   +++ b/node_modules/react-native-ble-plx/android/src/main/java/com/bleplx/BlePlxModule.java
   @@ -168,7 +168,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
   }, new OnErrorCallback() {
   @OverRide
   public void onError(BleError error) {

   •    safePromise.reject(null, errorConverter.toJs(error));
     

   •    safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
      }
     

     });
     }
     @@ -187,7 +187,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
     }, new OnErrorCallback() {
     @OverRide
     public void onError(BleError error) {

   •    safePromise.reject(null, errorConverter.toJs(error));
     

   •    safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
      }
     

     });
     }
     @@ -318,7 +318,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
     }, new OnErrorCallback() {
     @OverRide
     public void onError(BleError error) {

   •      safePromise.reject(null, errorConverter.toJs(error));
     

   •      safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
        }
      });
     

     }
     @@ -338,7 +338,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
     }, new OnErrorCallback() {
     @OverRide
     public void onError(BleError error) {

   •      safePromise.reject(null, errorConverter.toJs(error));
     

   •      safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
        }
      });
     

     }
     @@ -358,7 +358,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
     }, new OnErrorCallback() {
     @OverRide
     public void onError(BleError error) {

   •      safePromise.reject(null, errorConverter.toJs(error));
     

   •      safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
        }
      });
     

     }
     @@ -422,7 +422,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
     new OnErrorCallback() {
     @OverRide
     public void onError(BleError error) {

   •      safePromise.reject(null, errorConverter.toJs(error));
     

   •      safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
        }
      });
     

     }
     @@ -442,7 +442,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
     }, new OnErrorCallback() {
     @OverRide
     public void onError(BleError error) {

   •      safePromise.reject(null, errorConverter.toJs(error));
     

   •      safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
        }
      });
     

     }
     @@ -483,7 +483,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
     }, new OnErrorCallback() {
     @OverRide
     public void onError(BleError error) {

   •      safePromise.reject(null, errorConverter.toJs(error));
     

   •      safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
        }
      });
     

     }
     @@ -627,7 +627,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
     }, new OnErrorCallback() {
     @OverRide
     public void onError(BleError error) {

   •      safePromise.reject(null, errorConverter.toJs(error));
     

   •      safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
        }
      }
     

     );
     @@ -654,7 +654,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
     }, new OnErrorCallback() {
     @OverRide
     public void onError(BleError error) {

   •      safePromise.reject(null, errorConverter.toJs(error));
     

   •      safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
        }
      }
     

     );
     @@ -680,7 +680,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
     }, new OnErrorCallback() {
     @OverRide
     public void onError(BleError error) {

   •      safePromise.reject(null, errorConverter.toJs(error));
     

   •      safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
        }
      });
     

     }
     @@ -706,7 +706,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
     }, new OnErrorCallback() {
     @OverRide
     public void onError(BleError error) {

   •      safePromise.reject(null, errorConverter.toJs(error));
     

   •      safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
        }
      }
     

     );
     @@ -732,7 +732,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
     }, new OnErrorCallback() {
     @OverRide
     public void onError(BleError error) {

   •      safePromise.reject(null, errorConverter.toJs(error));
     

   •      safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
        }
      }
     

     );
     @@ -757,7 +757,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
     }, new OnErrorCallback() {
     @OverRide
     public void onError(BleError error) {

   •      safePromise.reject(null, errorConverter.toJs(error));
     

   •      safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
        }
      }
     

     );
     @@ -788,7 +788,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
     }, new OnErrorCallback() {
     @OverRide
     public void onError(BleError error) {

   •      safePromise.reject(null, errorConverter.toJs(error));
     

   •      safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
        }
      }
     

     );
     @@ -818,7 +818,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
     }, new OnErrorCallback() {
     @OverRide
     public void onError(BleError error) {

   •      safePromise.reject(null, errorConverter.toJs(error));
     

   •      safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
        }
      }
     

     );
     @@ -848,7 +848,7 @@ public class BlePlxModule extends ReactContextBaseJavaModule {
     }, new OnErrorCallback() {
     @OverRide
     public void onError(BleError error) {

   •      safePromise.reject(null, errorConverter.toJs(error));
     

   •      safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
        }
      }
     

     );

   Step 4: Apply the patch

   Apply the patch immediately

   npx patch-package

   For Expo projects - rebuild native code (required for Android changes)

   npx expo prebuild --clean

   For standard React Native projects

   npx react-native run-android

   How It Works

   Automatic Application

   The patch is automatically applied via the postinstall script:

   • Every npm install - Patch gets applied automatically
   • Every npm ci - Same automatic application
   • After dependency updates - Ensures the patch persists
   • On new team member setup - Automatically applies when they install dependencies

   What Gets Fixed

   The patch fixes 17 instances in BlePlxModule.java where:

   // BEFORE (causes crashes):
   safePromise.reject(null, errorConverter.toJs(error));

   // AFTER (fixed):
   safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));
   This affects all BLE monitoring operations:

   • characteristic.monitor() calls
   • Button press monitoring
   • Sensor data monitoring
   • Battery level monitoring
   • Distance/RSSI monitoring

   Verification

   Test the fix:

   1. Connect to a BLE device
   2. Start characteristic monitoring
   3. Manually disconnect the device (turn off, move out of range, etc.)
   4. App should handle disconnect gracefully without crashing

   Expected behavior:

   • ✅ No native crashes during disconnect
   • ✅ Clean disconnect handling
   • ✅ Proper error reporting with valid error codes
   • ✅ App continues to function normally

   Benefits

   1. Automatic - No manual intervention needed after setup
   2. Persistent - Survives dependency updates and team onboarding
   3. Version-controlled - The patch file is committed to your repo
   4. Reliable - Works consistently across different environments
   5. Minimal - Only fixes the specific issue without other modifications
   6. Production-ready - Safe for production use

   Compatibility

   • ✅ React Native 0.81.4+
   • ✅ Expo SDK 54+
   • ✅ react-native-ble-plx 3.2.1, 3.5.0
   • ✅ Android (primary fix)
   • ✅ iOS (no changes needed, works normally)

   This fix has been tested and verified to resolve BLE disconnect crashes in production React Native applications. `

   This patch is working, thank you so much
8. mrtomhoward commented on Oct 9, 2025

   

   mrtomhoward

   on Oct 9, 2025

   More actions

   This patch worked perfectly, thank you @thenjneer!
9. potocpav commented on Oct 9, 2025

   

   potocpav

   on Oct 9, 2025

   More actions

   Works for me as well! ❤️
10. lamebear commented on Oct 10, 2025

    

    lamebear

    on Oct 10, 2025

    More actions

    Thank you!
11. shynst commented on Oct 13, 2025

    

    shynst

    on Oct 13, 2025

    More actions

    Thank you for taking the effort of digging into this issue which is bugging me just now.
    I guess SafePromise isn't so safe after all... ;-)

    I'd like to add something here: SafePromise.reject() delegates to com.facebook.react.bridge.Promise.reject() and this is were the exception is thrown. So we need to look further. A simple search for .reject(null in my IDE revealed 35 occurrences in total. All of those can be replayed with .reject(error.errorCode.name().

    Hope we are safe again with SafePromise after all.
12. jorismangel commented on Oct 21, 2025

    

    jorismangel

    on Oct 21, 2025

    Last edited by jorismangel

    More actions

    Hello,

    If you having issues applying the patch with patch-package, please follow these steps:

    1. Create a file fix-ble.js at your project root:
    2. Copy-paste the below content
    3. Add "scripts": { "postinstall": "node fix-ble.js" } to your package.json
    4. Run rm -rf node_modules && yarn install (or equivalent with npm)
    5. Run grep "safePromise.reject(error.errorCode.name()" node_modules/react-native-ble-plx/android/src/main/java/com/bleplx/BlePlxModule.java | wc -l to check if the patch has been applied => you should have 17
    6. Rebuild on android cd android && ./gradlew generateCodegenArtifactsFromSchema && ./gradlew clean && ./gradlew assembleDebug && cd .. && yarn android

    Here is the content for fix-ble.js:

    const fs = require('fs');
    const path = require('path');
    const filePath = path.join(__dirname, 'node_modules/react-native-ble-plx/android/src/main/java/com/bleplx/BlePlxModule.java');
    
    let content = fs.readFileSync(filePath, 'utf8');
    content = content.replace(/safePromise\.reject\(null, errorConverter\.toJs\(error\)\);/g, 'safePromise.reject(error.errorCode.name(), errorConverter.toJs(error));');
    
    fs.writeFileSync(filePath, content, 'utf8');
    
    

    👍React with 👍2Reacted by MoJavad Jalilvand and acsel1985
13. jacklevin74

    added a commit that references this issue on Nov 10, 2025

    Fix Ledger BLE connection crashes on Android RN 0.81+

    ...

    df5ca40
14. prathje commented on Nov 18, 2025

    

    prathje

    on Nov 18, 2025

    More actions

    Note that (until this gets merged) you can simply install b1naryth1ef's fork via:

    npm install --save https://github.com/b1naryth1ef/react-native-ble-plx.git#fix/promise-rejection
15. leonzdev

    added a commit that references this issue on Nov 19, 2025

    Hot patch an upstream bug. Ref: dotintent/react-native-ble-plx#1303

    4e50e1b
16. Zee2 commented on Dec 23, 2025

    

    Zee2

    on Dec 23, 2025

    Last edited by Zee2

    More actions

    Hitting this too - hopefully this will be upstreamed soon. (Until then - maybe a note on the README about known issues with the latest rn versions?)
17. aliberski commented on Mar 9, 2026

    

    aliberski

    on Mar 9, 2026

    Collaborator

    More actions

    This is already fixed in the latest version 3.5.1 (PR for reference)
18. aliberski

    closed this as completedon Mar 9, 2026