bridgefy-react-native 1.1.7 → 1.1.9

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023 Bridgefy Inc
+Copyright (c) 2025 contact@bridgefy.me
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
 in the Software without restriction, including without limitation the rights

package/README.md

@@ -1,55 +1,63 @@
+
 <p align="center">
-    <img src="https://www.gitbook.com/cdn-cgi/image/width=256,dpr=2,height=40,fit=contain,format=auto/https%3A%2F%2F3290834949-files.gitbook.io%2F~%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F5XKIMMP6VF2l9XuPV80l%252Flogo%252Fd78nQFIysoU2bbM5fYNP%252FGroup%25203367.png%3Falt%3Dmedia%26token%3Df83a642d-8a9a-411f-9ef4-d7189a4c5f0a" />
+  <img src="https://www.gitbook.com/cdn-cgi/image/width=256,dpr=2,height=40,fit=contain,format=auto/https%3A%2F%2F3290834949-files.gitbook.io%2F~%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F5XKIMMP6VF2l9XuPV80l%252Flogo%252Fd78nQFIysoU2bbM5fYNP%252FGroup%25203367.png%3Falt%3Dmedia%26token%3Df83a642d-8a9a-411f-9ef4-d7189a4c5f0a" />
 </p>
 
 <p align="center">
-    <img src="https://3290834949-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5XKIMMP6VF2l9XuPV80l%2Fuploads%2FD0HSf0lWC4pWB4U7inIw%2Fharegit.jpg?alt=media&token=a400cf7d-3254-4afc-bed0-48f7d98205b0"/>
+  <img src="https://3290834949-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5XKIMMP6VF2l9XuPV80l%2Fuploads%2FD0HSf0lWC4pWB4U7inIw%2Fharegit.jpg?alt=media&token=a400cf7d-3254-4afc-bed0-48f7d98205b0" />
 </p>
 
 # Bridgefy React Native SDK
+
 ![GitHub last commit](https://img.shields.io/github/last-commit/bridgefy/bridgefy-react-native)
 ![GitHub issues](https://img.shields.io/github/issues-raw/bridgefy/bridgefy-react-native?style=plastic)
 
-The Bridgefy Software Development Kit (SDK) is a state-of-the-art, plug-and-play package that will let people use your mobile app when they don’t have access to the Internet, by using Bluetooth mesh networks.
+The **Bridgefy Software Development Kit (SDK)** is a state‑of‑the‑art plug‑and‑play solution that enables offline communication in your mobile apps by using Bluetooth mesh networks.
 
-Integrate the Bridgefy SDK into your Android and iOS app to reach the 3.5 billion people that don’t always have access to an Internet connection, and watch engagement and revenue grow!
+Integrate the Bridgefy SDK into your Android and iOS app to reach users who don't always have a reliable Internet connection and keep engagement high even in challenging environments.
 
-**Website**. https://bridgefy.me/sdk <br>
-**Email**. contact@bridgefy.me <br>
-**witter**. https://twitter.com/bridgefy <br>
-**Facebook**. https://www.facebook.com/bridgefy <br>
+**Website:** [https://bridgefy.me/sdk](https://bridgefy.me/sdk)
+**Email:** [contact@bridgefy.me](mailto:contact@bridgefy.me)
+**Twitter:** [https://twitter.com/bridgefy](https://twitter.com/bridgefy)
+**Facebook:** [https://www.facebook.com/bridgefy](https://www.facebook.com/bridgefy)
+
+---
 
 ## Operation mode
 
-All the connections are handled seamlessly by the SDK to create a mesh network. The size of this
-network depends on the number of devices connected and the environment as a variable factor,
-allowing you to join nodes in the same network or nodes in different networks.
+Bridgefy automatically manages device discovery and connections to create a **mesh network**, whose size depends on the number of nearby devices and environmental conditions.
+This mesh allows messages to hop across multiple devices, letting nodes in the same cluster or in different clusters exchange data without Internet access.
 
 ![networking](https://images.saymedia-content.com/.image/t_share/MTkzOTUzODU0MDkyNjE3MjIx/particlesjs-examples.gif)
 
+---
+
 ## Platform permissions
 
-To utilize this SDK in a React Native application, you'll need to configure permissions for each
-individual platform (iOS and Android) first. You can read more about each platform's requirements
-below:
+Before using the SDK in a React Native app, configure the required permissions at the native level for each platform.
 
-* [iOS Permissions](https://github.com/bridgefy/sdk-ios#permissions)
-* [Android Permissions](https://github.com/bridgefy/sdk-android#android-permissions)
+- [iOS Permissions](https://github.com/bridgefy/sdk-ios#permissions)
+- [Android Permissions](https://github.com/bridgefy/sdk-android#android-permissions)
+
+---
 
 ## Installation
 
+Install the SDK via npm or Yarn.
+
 ```bash
-$ npm i bridgefy-react-native
-# --- or ---
-$ yarn install bridgefy-react-native
+npm i bridgefy-react-native
+# or
+yarn add bridgefy-react-native
 ```
 
+---
+
 ## Usage
 
 ### Initialization
 
-The `initialize` method initializes the Bridgefy SDK with the given API key and propagation profile.
-We will configure event listeners later.
+Use `initialize` to configure the Bridgefy SDK with your API key and base options.
 
 ```typescript
 import { Bridgefy, BridgefyPropagationProfile } from 'bridgefy-react-native';
@@ -57,47 +65,50 @@ import { Bridgefy, BridgefyPropagationProfile } from 'bridgefy-react-native';
 const bridgefy = new Bridgefy();
 
 export default function App() {
-    React.useEffect(() => {
-        bridgefy
-            .initialize({
-                apiKey: 'your-api-key-here', // UUID - The license key registered on the Bridgefy developer site.
-                verboseLogging: false, // The logging priority for SDK operations.
-            })
-            .catch((error) => {
-                console.error(error);
-            });
-    });
+  React.useEffect(() => {
+    bridgefy
+      .initialize({
+        apiKey: 'your-api-key-here', // UUID - Your Bridgefy license key.
+        verboseLogging: false,       // Enables or disables verbose logs.
+        operationMode: 'hybrid',     // foreground | background | hybrid
+      })
+      .catch((error) => {
+        console.error(error);
+      });
+  }, []);
 }
 ```
 
-Once initialized, you can call `start` and `stop` Bridgefy SDK operations as follows:
+### Starting and stopping the SDK
+
+Once initialized, you can start or stop the SDK as needed.
 
 ```typescript
 /**
  * Start Bridgefy SDK operations
  */
 bridgefy.start(
-  userId, // UUID? (optional) - The ID used to identify the user in the Bridgefy network.If null is passed, the SDK will assign an autogenerated ID.
-  propagationProfile, // PropagationProfile (optional, default: PropagationProfile.Standard) - A profile that defines a series of properties and rules for the propagation of messages.
+  userId,              // Optional UUID - Custom user identifier in the network.
+  propagationProfile,  // Optional BridgefyPropagationProfile - Message propagation profile.
 );
 
 /**
  * Stop Bridgefy SDK operations
  */
-bridgefy.stop()
+bridgefy.stop();
 ```
 
-### Sending data
+---
+
+## Sending data
 
-The following method is used to send data using a transmission mode. This method returns a UUID to
-identify the message that was sent. You'll need to serialize your data into a `string` before
-transmission so React Native can communicate the information to the native platform.
+Use `send` to transmit serialized string data using a transmission mode.
 
 ```typescript
 async function sendData() {
   const userId = await bridgefy.currentUserId();
   const lastMessageId = await bridgefy.send(
-    'data', // String encoded data to send.
+    'data', // String-encoded data to send.
     {
       type: BridgefyTransmissionModeType.broadcast,
       uuid: userId,
@@ -106,12 +117,14 @@ async function sendData() {
 }
 ```
 
-### Responding to SDK events
+The method returns a message UUID you can use for tracking or acknowledgement flows.
 
-The SDK can report events to your app through an instance of React's `NativeEventEmitter`.
+---
 
-The following is an example subscription to a couple of events. Each message will contain
-information relevant to the event being transmitted.
+## Handling SDK events
+
+Bridgefy emits lifecycle and messaging events through React Native's `NativeEventEmitter`.
+Subscribe to events to track startup, incoming messages, errors, and other state changes.
 
 ```typescript
 React.useEffect(() => {
@@ -119,67 +132,115 @@ React.useEffect(() => {
   const eventEmitter = new NativeEventEmitter(
     NativeModules.BridgefyReactNative
   );
-  // When the Bridgefy SDK started successfully.
+
+  // Fired when the Bridgefy SDK has started successfully.
   subscriptions.push(
     eventEmitter.addListener(BridgefyEvents.bridgefyDidStart, (event) => {
-      console.log(`Bridgefy started`, event);
+      console.log('Bridgefy started', event);
     })
   );
-  // When this device received data from another Bridgefy device.
+
+  // Fired when this device receives data from another Bridgefy device.
   subscriptions.push(
     eventEmitter.addListener(
       BridgefyEvents.bridgefyDidReceiveData,
       (event) => {
-        console.log(`Bridgefy received data`, event);
+        console.log('Bridgefy received data', event);
       }
     )
   );
+
   return () => {
     for (const sub of subscriptions) {
       sub.remove();
     }
   };
-});
+}, []);
 ```
 
-To see a full list of events, see the `BridgefyEvents` enum.
+For a complete list of available events, see the `BridgefyEvents` enum in the SDK API reference.
+
+---
+
+## Additional functionality
+
+The `Bridgefy` class exposes several helper methods to manage sessions, connectivity, and licensing.
+
+- `destroySession()`: Destroys the current SDK session and cleans local state.
+- `establishSecureConnection(userId: string): Promise<void>`: Establishes an end-to-end encrypted connection with the specified peer.
+- `currentUserId(): Promise<string>`: Returns the current device's user identifier.
+- `connectedPeers(): Promise<string[]>`: Returns the list of currently connected peers.
+- `licenseExpirationDate(): Promise<Date>`: Returns the configured license expiration date.
+- `updateLicense(): Promise<void>`: Refreshes the SDK license (for renewed or upgraded plans).
+- `isInitialized(): Promise<boolean>`: Indicates whether the SDK has been initialized.
+- `isStarted(): Promise<boolean>`: Indicates whether the SDK is currently running.
+
+### Operation mode control
+
+These methods let you inspect and change how Bridgefy runs at runtime.
+
+- `setOperationMode(config: BridgefyOperationModeConfig): Promise<BridgefyOperationModeConfig>`
+- `getOperationMode(): Promise<BridgefyOperationModeConfig>`
+- `switchToBackground(): Promise<void>`
+- `switchToForeground(): Promise<void>`
+- `getOperationStatus(): Promise<BridgefyOperationModeStatus>`
+
+Always handle promises and error cases to keep your networking layer **robust** and responsive.
+
+---
+
+## Bridgefy propagation profiles
+
+The `BridgefyPropagationProfile` enum defines presets for how messages propagate through the mesh, so you can tune behavior to your use case.
+
+- `STANDARD`: Balanced default profile for general messaging.
+- `HIGH_DENSITY_NETWORK`: Optimized for crowded environments such as concerts or stadiums.
+- `SPARSE_NETWORK`: Suitable for rural or low-density areas.
+- `LONG_REACH`: Prioritizes maximum distance, useful for emergencies or outdoor activities.
+- `SHORT_REACH`: Focuses on nearby devices only.
+- `REALTIME`: Prioritizes ultra-low latency for time-sensitive notifications.
+
+---
+
+## Background/foreground operation modes guide
 
-## Additional Functionality
-The `Bridgefy` class also provides various functionalities:
+Bridgefy supports three main operation modes with different trade-offs in availability and battery usage.
 
-- `destroySession()`: Destroy current session.
-- `updateLicense()`: Update license.
-- `establishSecureConnection(userId: string): Promise<void>`: Establish a secure connection with a specified user.
-- `currentUserId(): Promise<string>`: Get the current user ID.
-- `connectedPeers(): Promise<string[]>`: Get a list of connected peers.
-- `licenseExpirationDate(): Promise<Date>`: Get the license expiration date.
-- `isInitialized(): Promise<boolean>`: Check if the SDK is initialized.
-- `isStarted(): Promise<boolean>`: Check if the SDK is started.
+1. **FOREGROUND mode**
+  - SDK runs only while the app is in the foreground.
+  - No persistent background service.
+  - Lower battery usage and simpler integration.
+  - Good for development, demos, or foreground-only use cases.
 
-Make sure to handle promises and error scenarios appropriately when using these methods.
+2. **BACKGROUND mode** (Android)
+  - SDK runs continuously in a foreground service, even when the app is backgrounded.
+  - Enables always-on mesh networking and better reachability.
+  - Higher battery consumption; best for critical connectivity scenarios.
 
-## Bridgefy Propagation Profiles
+3. **HYBRID mode (recommended)**
+  - Runs in the foreground while the app is active.
+  - Automatically switches to background mode when the app is backgrounded.
+  - Automatically resumes foreground mode when the app becomes active again.
+  - Smart balance between connectivity and battery for the best user experience.
 
-The `BridgefyPropagationProfile` enum defines the following propagation profiles available for use:
+---
 
-- `standard`: Standard propagation profile.
-- `highDensityNetwork`: High-density network profile.
-- `sparseNetwork`: Sparse network profile.
-- `longReach`: Long-reach profile.
-- `shortReach`: Short-reach profile.
+## Multi-platform support
 
-These profiles can be used when configuring the Bridgefy SDK operations within your React Native application.
+Bridgefy SDKs interoperate across platforms so iOS and Android devices can communicate seamlessly as long as they run a Bridgefy-enabled app.
 
+- [Bridgefy iOS](https://github.com/bridgefy/sdk-ios)
+- [Bridgefy Android](https://github.com/bridgefy/sdk-android)
 
+---
 
-## Multi-Platform Support
+## Contact & support
 
-Bridgefy's SDKs are designed to work seamlessly across different platforms, including iOS and Android. This means that users with different devices can communicate with each other as long as they have the Bridgefy-enabled applications installed.
+For commercial inquiries, technical questions, or integration help, reach out using the channels below.
 
-* [Bridgefy iOS](https://github.com/bridgefy/sdk-ios)
-* [Bridgefy Android](https://github.com/bridgefy/sdk-android)
+- Email: [contact@bridgefy.me](mailto:contact@bridgefy.me)
+- Website: [https://bridgefy.me/sdk](https://bridgefy.me/sdk)
 
-## Contact & Support
-+ contact@bridgefy.me
+---
 
-© 2023 Bridgefy Inc. All rights reserved
+© 2026 Bridgefy Inc. All rights reserved.

package/android/build.gradle

@@ -1,74 +1,52 @@
 buildscript {
-  // Buildscript is evaluated before everything else so we can't use getExtOrDefault
-  def kotlin_version = rootProject.ext.has("kotlinVersion") ? rootProject.ext.get("kotlinVersion") : project.properties["BridgefyReactNative_kotlinVersion"]
+  ext.getExtOrDefault = {name ->
+    return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties['BridgefyReactNative_' + name]
+  }
 
+  rootProject.allprojects {
+    repositories {
+      maven {
+        url "http://34.82.5.94:8081/artifactory/libs-release-local"
+        allowInsecureProtocol = true
+      }
+    }
+  }
   repositories {
     google()
     mavenCentral()
   }
 
   dependencies {
-    classpath "com.android.tools.build:gradle:8.5.2"
+    classpath "com.android.tools.build:gradle:8.7.2"
     // noinspection DifferentKotlinGradleVersion
-    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
   }
 }
 
-rootProject.allprojects {
-  repositories {
-    maven {
-      url "http://34.82.5.94:8081/artifactory/libs-release-local"
-      allowInsecureProtocol = true
-    }
-  }
-}
-
-allprojects {
-  repositories {
-    google()
-    mavenCentral()
-  }
-}
-
-def isNewArchitectureEnabled() {
-  return rootProject.hasProperty("newArchEnabled") && rootProject.getProperty("newArchEnabled") == "true"
-}
 
 apply plugin: "com.android.library"
 apply plugin: "kotlin-android"
 
-
-def appProject = rootProject.allprojects.find { it.plugins.hasPlugin('com.android.application') }
-
-if (isNewArchitectureEnabled()) {
-  apply plugin: "com.facebook.react"
-}
-
-def getExtOrDefault(name) {
-  return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties["BridgefyReactNative_" + name]
-}
+apply plugin: "com.facebook.react"
 
 def getExtOrIntegerDefault(name) {
   return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["BridgefyReactNative_" + name]).toInteger()
 }
 
 android {
-  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
-
-  compileOptions {
-    sourceCompatibility JavaVersion.VERSION_17
-    targetCompatibility JavaVersion.VERSION_17
-  }
+  namespace "me.bridgefy.plugin.react_native"
 
-  kotlinOptions {
-    jvmTarget = '17'
-  }
+  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
 
   defaultConfig {
     minSdkVersion getExtOrIntegerDefault("minSdkVersion")
     targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
-    buildConfigField "boolean", "IS_NEW_ARCHITECTURE_ENABLED", isNewArchitectureEnabled().toString()
   }
+
+  buildFeatures {
+    buildConfig true
+  }
+
   buildTypes {
     release {
       minifyEnabled false
@@ -78,6 +56,20 @@ android {
   lintOptions {
     disable "GradleCompatible"
   }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+
+  sourceSets {
+    main {
+      java.srcDirs += [
+        "generated/java",
+        "generated/jni"
+      ]
+    }
+  }
 }
 
 repositories {
@@ -88,20 +80,9 @@ repositories {
 def kotlin_version = getExtOrDefault("kotlinVersion")
 
 dependencies {
-  implementation (group: "me.bridgefy", name: "android-sdk", version: "1.2.2", ext: "aar") {
+  implementation (group: "me.bridgefy", name: "android-sdk", version: "1.2.5", ext: "aar") {
     transitive = true
   }
-  // For < 0.71, this will be from the local maven repo
-  // For > 0.71, this will be replaced by `com.facebook.react:react-android:$version` by react gradle plugin
-  //noinspection GradleDynamicVersion
-  implementation "com.facebook.react:react-native:+"
+  implementation "com.facebook.react:react-android"
   implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
 }
-
-if (isNewArchitectureEnabled()) {
-  react {
-    jsRootDir = file("../src/")
-    libraryName = "BridgefyReactNative"
-    codegenJavaPackageName = "me.bridgefy.plugin.react_native"
-  }
-}

package/android/gradle.properties

@@ -1,5 +1,5 @@
-BridgefyReactNative_kotlinVersion=2.0.20
-BridgefyReactNative_minSdkVersion=21
-BridgefyReactNative_targetSdkVersion=35
+BridgefyReactNative_kotlinVersion=2.0.21
+BridgefyReactNative_minSdkVersion=24
+BridgefyReactNative_targetSdkVersion=34
 BridgefyReactNative_compileSdkVersion=35
-BridgefyReactNative_ndkversion=28.0.12916984
+BridgefyReactNative_ndkVersion=27.1.12297006

package/android/src/main/AndroidManifest.xml

@@ -1,12 +1,2 @@
-<manifest xmlns:android="http://schemas.android.com/apk/res/android"
-  xmlns:tools="http://schemas.android.com/tools"
-  package="me.bridgefy.plugin.react_native">
-  <uses-permission-sdk-23 android:name="android.permission.ACCESS_COARSE_LOCATION" android:maxSdkVersion="30" tools:node="replace" />
-  <uses-permission-sdk-23 android:name="android.permission.ACCESS_FINE_LOCATION" tools:node="replace" />
-  <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" android:maxSdkVersion="30" />
-  <uses-permission android:name="android.permission.BLUETOOTH" />
-  <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
-  <uses-permission android:name="android.permission.BLUETOOTH_SCAN" tools:node="replace" />
-  <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
-  <uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE" />
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
 </manifest>