munim-bluetooth 0.3.24 → 0.3.26

package/lib/typescript/src/specs/munim-bluetooth.nitro.d.ts

@@ -58,6 +58,16 @@ export interface AdvertisingOptions {
     manufacturerData?: string;
     advertisingData?: AdvertisingDataTypes;
 }
+export interface BackgroundSessionOptions {
+    serviceUUIDs: string[];
+    localName?: string;
+    allowDuplicates?: boolean;
+    scanMode?: ScanMode;
+    androidNotificationChannelId?: string;
+    androidNotificationChannelName?: string;
+    androidNotificationTitle?: string;
+    androidNotificationText?: string;
+}
 export interface MunimBluetooth extends HybridObject<{
     ios: 'swift';
     android: 'kotlin';
@@ -179,10 +189,22 @@ export interface MunimBluetooth extends HybridObject<{
     /**
      * Read RSSI (signal strength) for a connected device.
      *
-     * @param deviceId - The unique identifier of the connected device.
-     * @returns Promise resolving to RSSI value in dBm.
-     */
+    * @param deviceId - The unique identifier of the connected device.
+    * @returns Promise resolving to RSSI value in dBm.
+    */
     readRSSI(deviceId: string): Promise<number>;
+    /**
+     * Start a best-effort background BLE session.
+     *
+     * Android uses a foreground service so BLE can continue after the app leaves the foreground.
+     * iOS keeps the central/peripheral managers running and relies on the host app's Bluetooth
+     * background modes for best-effort background operation.
+     */
+    startBackgroundSession(options: BackgroundSessionOptions): void;
+    /**
+     * Stop the active background BLE session.
+     */
+    stopBackgroundSession(): void;
     /**
      * Add an event listener.
      *

package/lib/typescript/src/specs/munim-bluetooth.nitro.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"munim-bluetooth.nitro.d.ts","sourceRoot":"","sources":["../../../../src/specs/munim-bluetooth.nitro.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"munim-bluetooth.nitro.d.ts","sourceRoot":"","sources":["../../../../src/specs/munim-bluetooth.nitro.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAG9D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAGD,MAAM,WAAW,oBAAoB;IAEnC,KAAK,CAAC,EAAE,MAAM,CAAA;IAGd,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAA;IACnC,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAA;IACjC,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAA;IACnC,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAA;IACjC,yBAAyB,CAAC,EAAE,MAAM,EAAE,CAAA;IACpC,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAA;IAGlC,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAG1B,YAAY,CAAC,EAAE,MAAM,CAAA;IAGrB,0BAA0B,CAAC,EAAE,MAAM,EAAE,CAAA;IACrC,2BAA2B,CAAC,EAAE,MAAM,EAAE,CAAA;IAGtC,aAAa,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAClC,aAAa,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAClC,cAAc,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAGnC,UAAU,CAAC,EAAE,MAAM,CAAA;IAGnB,0BAA0B,CAAC,EAAE,MAAM,EAAE,CAAA;IAGrC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAGD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,eAAe,CAAC,EAAE,oBAAoB,CAAA;IACtC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAGD,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,CAAA;AAG7D,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB;AAGD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAGD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,eAAe,EAAE,kBAAkB,EAAE,CAAA;CACtC;AAGD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,kBAAkB,EAAE,MAAM,CAAA;CAC3B;AAGD,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,sBAAsB,CAAA;AAGxD,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,eAAe,CAAC,EAAE,oBAAoB,CAAA;CACvC;AAED,MAAM,WAAW,wBAAwB;IACvC,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,4BAA4B,CAAC,EAAE,MAAM,CAAA;IACrC,8BAA8B,CAAC,EAAE,MAAM,CAAA;IACvC,wBAAwB,CAAC,EAAE,MAAM,CAAA;IACjC,uBAAuB,CAAC,EAAE,MAAM,CAAA;CACjC;AAED,MAAM,WAAW,cACf,SAAQ,YAAY,CAAC;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,QAAQ,CAAA;CAAE,CAAC;IAGzD;;;;;OAKG;IACH,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAA;IAEnD;;;;OAIG;IACH,qBAAqB,CAAC,eAAe,EAAE,oBAAoB,GAAG,IAAI,CAAA;IAElE;;;;OAIG;IACH,kBAAkB,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAAA;IAEnD;;OAEG;IACH,eAAe,IAAI,IAAI,CAAA;IAEvB;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,CAAA;IAI1C;;;;OAIG;IACH,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IAEtC;;;;OAIG;IACH,0BAA0B,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IAE9C;;;;OAIG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;IAEtC;;OAEG;IACH,QAAQ,IAAI,IAAI,CAAA;IAEhB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAExC;;;;OAIG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAElC;;;;;OAKG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAA;IAE1D;;;;;;;OAOG;IACH,kBAAkB,CAChB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC,mBAAmB,CAAC,CAAA;IAE/B;;;;;;;;;OASG;IACH,mBAAmB,CACjB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,kBAAkB,EAAE,MAAM,EAC1B,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,SAAS,GACpB,OAAO,CAAC,IAAI,CAAC,CAAA;IAEhB;;;;;;OAMG;IACH,yBAAyB,CACvB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,kBAAkB,EAAE,MAAM,GACzB,IAAI,CAAA;IAEP;;;;;;OAMG;IACH,6BAA6B,CAC3B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,kBAAkB,EAAE,MAAM,GACzB,IAAI,CAAA;IAEP;;;;OAIG;IACH,mBAAmB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAExC;;;;;MAKE;IACF,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAE3C;;;;;;OAMG;IACH,sBAAsB,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAAA;IAE/D;;OAEG;IACH,qBAAqB,IAAI,IAAI,CAAA;IAI7B;;;;OAIG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IAEpC;;;;OAIG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrC"}

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

@@ -0,0 +1,107 @@
+///
+/// JBackgroundSessionOptions.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#include <fbjni/fbjni.h>
+#include "BackgroundSessionOptions.hpp"
+
+#include "JScanMode.hpp"
+#include "ScanMode.hpp"
+#include <optional>
+#include <string>
+#include <vector>
+
+namespace margelo::nitro::munimbluetooth {
+
+  using namespace facebook;
+
+  /**
+   * The C++ JNI bridge between the C++ struct "BackgroundSessionOptions" and the the Kotlin data class "BackgroundSessionOptions".
+   */
+  struct JBackgroundSessionOptions final: public jni::JavaClass<JBackgroundSessionOptions> {
+  public:
+    static constexpr auto kJavaDescriptor = "Lcom/margelo/nitro/munimbluetooth/BackgroundSessionOptions;";
+
+  public:
+    /**
+     * Convert this Java/Kotlin-based struct to the C++ struct BackgroundSessionOptions by copying all values to C++.
+     */
+    [[maybe_unused]]
+    [[nodiscard]]
+    BackgroundSessionOptions toCpp() const {
+      static const auto clazz = javaClassStatic();
+      static const auto fieldServiceUUIDs = clazz->getField<jni::JArrayClass<jni::JString>>("serviceUUIDs");
+      jni::local_ref<jni::JArrayClass<jni::JString>> serviceUUIDs = this->getFieldValue(fieldServiceUUIDs);
+      static const auto fieldLocalName = clazz->getField<jni::JString>("localName");
+      jni::local_ref<jni::JString> localName = this->getFieldValue(fieldLocalName);
+      static const auto fieldAllowDuplicates = clazz->getField<jni::JBoolean>("allowDuplicates");
+      jni::local_ref<jni::JBoolean> allowDuplicates = this->getFieldValue(fieldAllowDuplicates);
+      static const auto fieldScanMode = clazz->getField<JScanMode>("scanMode");
+      jni::local_ref<JScanMode> scanMode = this->getFieldValue(fieldScanMode);
+      static const auto fieldAndroidNotificationChannelId = clazz->getField<jni::JString>("androidNotificationChannelId");
+      jni::local_ref<jni::JString> androidNotificationChannelId = this->getFieldValue(fieldAndroidNotificationChannelId);
+      static const auto fieldAndroidNotificationChannelName = clazz->getField<jni::JString>("androidNotificationChannelName");
+      jni::local_ref<jni::JString> androidNotificationChannelName = this->getFieldValue(fieldAndroidNotificationChannelName);
+      static const auto fieldAndroidNotificationTitle = clazz->getField<jni::JString>("androidNotificationTitle");
+      jni::local_ref<jni::JString> androidNotificationTitle = this->getFieldValue(fieldAndroidNotificationTitle);
+      static const auto fieldAndroidNotificationText = clazz->getField<jni::JString>("androidNotificationText");
+      jni::local_ref<jni::JString> androidNotificationText = this->getFieldValue(fieldAndroidNotificationText);
+      return BackgroundSessionOptions(
+        [&]() {
+          size_t __size = serviceUUIDs->size();
+          std::vector<std::string> __vector;
+          __vector.reserve(__size);
+          for (size_t __i = 0; __i < __size; __i++) {
+            auto __element = serviceUUIDs->getElement(__i);
+            __vector.push_back(__element->toStdString());
+          }
+          return __vector;
+        }(),
+        localName != nullptr ? std::make_optional(localName->toStdString()) : std::nullopt,
+        allowDuplicates != nullptr ? std::make_optional(static_cast<bool>(allowDuplicates->value())) : std::nullopt,
+        scanMode != nullptr ? std::make_optional(scanMode->toCpp()) : std::nullopt,
+        androidNotificationChannelId != nullptr ? std::make_optional(androidNotificationChannelId->toStdString()) : std::nullopt,
+        androidNotificationChannelName != nullptr ? std::make_optional(androidNotificationChannelName->toStdString()) : std::nullopt,
+        androidNotificationTitle != nullptr ? std::make_optional(androidNotificationTitle->toStdString()) : std::nullopt,
+        androidNotificationText != nullptr ? std::make_optional(androidNotificationText->toStdString()) : std::nullopt
+      );
+    }
+
+  public:
+    /**
+     * Create a Java/Kotlin-based struct by copying all values from the given C++ struct to Java.
+     */
+    [[maybe_unused]]
+    static jni::local_ref<JBackgroundSessionOptions::javaobject> fromCpp(const BackgroundSessionOptions& value) {
+      using JSignature = JBackgroundSessionOptions(jni::alias_ref<jni::JArrayClass<jni::JString>>, jni::alias_ref<jni::JString>, jni::alias_ref<jni::JBoolean>, jni::alias_ref<JScanMode>, jni::alias_ref<jni::JString>, jni::alias_ref<jni::JString>, jni::alias_ref<jni::JString>, jni::alias_ref<jni::JString>);
+      static const auto clazz = javaClassStatic();
+      static const auto create = clazz->getStaticMethod<JSignature>("fromCpp");
+      return create(
+        clazz,
+        [&]() {
+          size_t __size = value.serviceUUIDs.size();
+          jni::local_ref<jni::JArrayClass<jni::JString>> __array = jni::JArrayClass<jni::JString>::newArray(__size);
+          for (size_t __i = 0; __i < __size; __i++) {
+            const auto& __element = value.serviceUUIDs[__i];
+            auto __elementJni = jni::make_jstring(__element);
+            __array->setElement(__i, *__elementJni);
+          }
+          return __array;
+        }(),
+        value.localName.has_value() ? jni::make_jstring(value.localName.value()) : nullptr,
+        value.allowDuplicates.has_value() ? jni::JBoolean::valueOf(value.allowDuplicates.value()) : nullptr,
+        value.scanMode.has_value() ? JScanMode::fromCpp(value.scanMode.value()) : nullptr,
+        value.androidNotificationChannelId.has_value() ? jni::make_jstring(value.androidNotificationChannelId.value()) : nullptr,
+        value.androidNotificationChannelName.has_value() ? jni::make_jstring(value.androidNotificationChannelName.value()) : nullptr,
+        value.androidNotificationTitle.has_value() ? jni::make_jstring(value.androidNotificationTitle.value()) : nullptr,
+        value.androidNotificationText.has_value() ? jni::make_jstring(value.androidNotificationText.value()) : nullptr
+      );
+    }
+  };
+
+} // namespace margelo::nitro::munimbluetooth

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

@@ -25,6 +25,8 @@ namespace margelo::nitro::munimbluetooth { struct ScanOptions; }
 namespace margelo::nitro::munimbluetooth { enum class ScanMode; }
 // Forward declaration of `WriteType` to properly resolve imports.
 namespace margelo::nitro::munimbluetooth { enum class WriteType; }
+// Forward declaration of `BackgroundSessionOptions` to properly resolve imports.
+namespace margelo::nitro::munimbluetooth { struct BackgroundSessionOptions; }
 
 #include "AdvertisingDataTypes.hpp"
 #include <NitroModules/Promise.hpp>
@@ -50,6 +52,8 @@ namespace margelo::nitro::munimbluetooth { enum class WriteType; }
 #include "JScanMode.hpp"
 #include "WriteType.hpp"
 #include "JWriteType.hpp"
+#include "BackgroundSessionOptions.hpp"
+#include "JBackgroundSessionOptions.hpp"
 
 namespace margelo::nitro::munimbluetooth {
 
@@ -289,6 +293,14 @@ namespace margelo::nitro::munimbluetooth {
       return __promise;
     }();
   }
+  void JHybridMunimBluetoothSpec::startBackgroundSession(const BackgroundSessionOptions& options) {
+    static const auto method = _javaPart->javaClassStatic()->getMethod<void(jni::alias_ref<JBackgroundSessionOptions> /* options */)>("startBackgroundSession");
+    method(_javaPart, JBackgroundSessionOptions::fromCpp(options));
+  }
+  void JHybridMunimBluetoothSpec::stopBackgroundSession() {
+    static const auto method = _javaPart->javaClassStatic()->getMethod<void()>("stopBackgroundSession");
+    method(_javaPart);
+  }
   void JHybridMunimBluetoothSpec::addListener(const std::string& eventName) {
     static const auto method = _javaPart->javaClassStatic()->getMethod<void(jni::alias_ref<jni::JString> /* eventName */)>("addListener");
     method(_javaPart, jni::make_jstring(eventName));

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

@@ -72,6 +72,8 @@ namespace margelo::nitro::munimbluetooth {
     void unsubscribeFromCharacteristic(const std::string& deviceId, const std::string& serviceUUID, const std::string& characteristicUUID) override;
     std::shared_ptr<Promise<std::vector<std::string>>> getConnectedDevices() override;
     std::shared_ptr<Promise<double>> readRSSI(const std::string& deviceId) override;
+    void startBackgroundSession(const BackgroundSessionOptions& options) override;
+    void stopBackgroundSession() override;
     void addListener(const std::string& eventName) override;
     void removeListeners(double count) override;
 

package/nitrogen/generated/android/kotlin/com/margelo/nitro/munimbluetooth/BackgroundSessionOptions.kt

@@ -0,0 +1,59 @@
+///
+/// BackgroundSessionOptions.kt
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+package com.margelo.nitro.munimbluetooth
+
+import androidx.annotation.Keep
+import com.facebook.proguard.annotations.DoNotStrip
+
+
+/**
+ * Represents the JavaScript object/struct "BackgroundSessionOptions".
+ */
+@DoNotStrip
+@Keep
+data class BackgroundSessionOptions(
+  @DoNotStrip
+  @Keep
+  val serviceUUIDs: Array<String>,
+  @DoNotStrip
+  @Keep
+  val localName: String?,
+  @DoNotStrip
+  @Keep
+  val allowDuplicates: Boolean?,
+  @DoNotStrip
+  @Keep
+  val scanMode: ScanMode?,
+  @DoNotStrip
+  @Keep
+  val androidNotificationChannelId: String?,
+  @DoNotStrip
+  @Keep
+  val androidNotificationChannelName: String?,
+  @DoNotStrip
+  @Keep
+  val androidNotificationTitle: String?,
+  @DoNotStrip
+  @Keep
+  val androidNotificationText: String?
+) {
+  /* primary constructor */
+
+  companion object {
+    /**
+     * Constructor called from C++
+     */
+    @DoNotStrip
+    @Keep
+    @Suppress("unused")
+    @JvmStatic
+    private fun fromCpp(serviceUUIDs: Array<String>, localName: String?, allowDuplicates: Boolean?, scanMode: ScanMode?, androidNotificationChannelId: String?, androidNotificationChannelName: String?, androidNotificationTitle: String?, androidNotificationText: String?): BackgroundSessionOptions {
+      return BackgroundSessionOptions(serviceUUIDs, localName, allowDuplicates, scanMode, androidNotificationChannelId, androidNotificationChannelName, androidNotificationTitle, androidNotificationText)
+    }
+  }
+}

package/nitrogen/generated/android/kotlin/com/margelo/nitro/munimbluetooth/HybridMunimBluetoothSpec.kt

@@ -26,85 +26,93 @@ import com.margelo.nitro.core.HybridObject
 )
 abstract class HybridMunimBluetoothSpec: HybridObject() {
   // Properties
-  
+
 
   // Methods
   @DoNotStrip
   @Keep
   abstract fun startAdvertising(options: AdvertisingOptions): Unit
-  
+
   @DoNotStrip
   @Keep
   abstract fun updateAdvertisingData(advertisingData: AdvertisingDataTypes): Unit
-  
+
   @DoNotStrip
   @Keep
   abstract fun getAdvertisingData(): Promise<AdvertisingDataTypes>
-  
+
   @DoNotStrip
   @Keep
   abstract fun stopAdvertising(): Unit
-  
+
   @DoNotStrip
   @Keep
   abstract fun setServices(services: Array<GATTService>): Unit
-  
+
   @DoNotStrip
   @Keep
   abstract fun isBluetoothEnabled(): Promise<Boolean>
-  
+
   @DoNotStrip
   @Keep
   abstract fun requestBluetoothPermission(): Promise<Boolean>
-  
+
   @DoNotStrip
   @Keep
   abstract fun startScan(options: ScanOptions?): Unit
-  
+
   @DoNotStrip
   @Keep
   abstract fun stopScan(): Unit
-  
+
   @DoNotStrip
   @Keep
   abstract fun connect(deviceId: String): Promise<Unit>
-  
+
   @DoNotStrip
   @Keep
   abstract fun disconnect(deviceId: String): Unit
-  
+
   @DoNotStrip
   @Keep
   abstract fun discoverServices(deviceId: String): Promise<Array<GATTService>>
-  
+
   @DoNotStrip
   @Keep
   abstract fun readCharacteristic(deviceId: String, serviceUUID: String, characteristicUUID: String): Promise<CharacteristicValue>
-  
+
   @DoNotStrip
   @Keep
   abstract fun writeCharacteristic(deviceId: String, serviceUUID: String, characteristicUUID: String, value: String, writeType: WriteType?): Promise<Unit>
-  
+
   @DoNotStrip
   @Keep
   abstract fun subscribeToCharacteristic(deviceId: String, serviceUUID: String, characteristicUUID: String): Unit
-  
+
   @DoNotStrip
   @Keep
   abstract fun unsubscribeFromCharacteristic(deviceId: String, serviceUUID: String, characteristicUUID: String): Unit
-  
+
   @DoNotStrip
   @Keep
   abstract fun getConnectedDevices(): Promise<Array<String>>
-  
+
   @DoNotStrip
   @Keep
   abstract fun readRSSI(deviceId: String): Promise<Double>
-  
+
+  @DoNotStrip
+  @Keep
+  abstract fun startBackgroundSession(options: BackgroundSessionOptions): Unit
+
+  @DoNotStrip
+  @Keep
+  abstract fun stopBackgroundSession(): Unit
+
   @DoNotStrip
   @Keep
   abstract fun addListener(eventName: String): Unit
-  
+
   @DoNotStrip
   @Keep
   abstract fun removeListeners(count: Double): Unit

package/nitrogen/generated/ios/MunimBluetooth-Swift-Cxx-Umbrella.hpp

@@ -12,6 +12,8 @@
 namespace margelo::nitro::munimbluetooth { struct AdvertisingDataTypes; }
 // Forward declaration of `AdvertisingOptions` to properly resolve imports.
 namespace margelo::nitro::munimbluetooth { struct AdvertisingOptions; }
+// Forward declaration of `BackgroundSessionOptions` to properly resolve imports.
+namespace margelo::nitro::munimbluetooth { struct BackgroundSessionOptions; }
 // Forward declaration of `CharacteristicValue` to properly resolve imports.
 namespace margelo::nitro::munimbluetooth { struct CharacteristicValue; }
 // Forward declaration of `GATTCharacteristic` to properly resolve imports.
@@ -32,6 +34,7 @@ namespace margelo::nitro::munimbluetooth { enum class WriteType; }
 // Include C++ defined types
 #include "AdvertisingDataTypes.hpp"
 #include "AdvertisingOptions.hpp"
+#include "BackgroundSessionOptions.hpp"
 #include "CharacteristicValue.hpp"
 #include "GATTCharacteristic.hpp"
 #include "GATTService.hpp"

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

@@ -30,6 +30,8 @@ namespace margelo::nitro::munimbluetooth { enum class ScanMode; }
 namespace margelo::nitro::munimbluetooth { struct CharacteristicValue; }
 // Forward declaration of `WriteType` to properly resolve imports.
 namespace margelo::nitro::munimbluetooth { enum class WriteType; }
+// Forward declaration of `BackgroundSessionOptions` to properly resolve imports.
+namespace margelo::nitro::munimbluetooth { struct BackgroundSessionOptions; }
 
 #include "AdvertisingOptions.hpp"
 #include <string>
@@ -44,6 +46,7 @@ namespace margelo::nitro::munimbluetooth { enum class WriteType; }
 #include "ScanMode.hpp"
 #include "CharacteristicValue.hpp"
 #include "WriteType.hpp"
+#include "BackgroundSessionOptions.hpp"
 
 #include "MunimBluetooth-Swift-Cxx-Umbrella.hpp"
 
@@ -221,6 +224,18 @@ namespace margelo::nitro::munimbluetooth {
       auto __value = std::move(__result.value());
       return __value;
     }
+    inline void startBackgroundSession(const BackgroundSessionOptions& options) override {
+      auto __result = _swiftPart.startBackgroundSession(std::forward<decltype(options)>(options));
+      if (__result.hasError()) [[unlikely]] {
+        std::rethrow_exception(__result.error());
+      }
+    }
+    inline void stopBackgroundSession() override {
+      auto __result = _swiftPart.stopBackgroundSession();
+      if (__result.hasError()) [[unlikely]] {
+        std::rethrow_exception(__result.error());
+      }
+    }
     inline void addListener(const std::string& eventName) override {
       auto __result = _swiftPart.addListener(eventName);
       if (__result.hasError()) [[unlikely]] {

package/nitrogen/generated/ios/swift/BackgroundSessionOptions.swift

@@ -0,0 +1,154 @@
+///
+/// BackgroundSessionOptions.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+import NitroModules
+
+/**
+ * Represents an instance of `BackgroundSessionOptions`, backed by a C++ struct.
+ */
+public typealias BackgroundSessionOptions = margelo.nitro.munimbluetooth.BackgroundSessionOptions
+
+public extension BackgroundSessionOptions {
+  private typealias bridge = margelo.nitro.munimbluetooth.bridge.swift
+
+  /**
+   * Create a new instance of `BackgroundSessionOptions`.
+   */
+  init(serviceUUIDs: [String], localName: String?, allowDuplicates: Bool?, scanMode: ScanMode?, androidNotificationChannelId: String?, androidNotificationChannelName: String?, androidNotificationTitle: String?, androidNotificationText: String?) {
+    self.init({ () -> bridge.std__vector_std__string_ in
+      var __vector = bridge.create_std__vector_std__string_(serviceUUIDs.count)
+      for __item in serviceUUIDs {
+        __vector.push_back(std.string(__item))
+      }
+      return __vector
+    }(), { () -> bridge.std__optional_std__string_ in
+      if let __unwrappedValue = localName {
+        return bridge.create_std__optional_std__string_(std.string(__unwrappedValue))
+      } else {
+        return .init()
+      }
+    }(), { () -> bridge.std__optional_bool_ in
+      if let __unwrappedValue = allowDuplicates {
+        return bridge.create_std__optional_bool_(__unwrappedValue)
+      } else {
+        return .init()
+      }
+    }(), { () -> bridge.std__optional_ScanMode_ in
+      if let __unwrappedValue = scanMode {
+        return bridge.create_std__optional_ScanMode_(__unwrappedValue)
+      } else {
+        return .init()
+      }
+    }(), { () -> bridge.std__optional_std__string_ in
+      if let __unwrappedValue = androidNotificationChannelId {
+        return bridge.create_std__optional_std__string_(std.string(__unwrappedValue))
+      } else {
+        return .init()
+      }
+    }(), { () -> bridge.std__optional_std__string_ in
+      if let __unwrappedValue = androidNotificationChannelName {
+        return bridge.create_std__optional_std__string_(std.string(__unwrappedValue))
+      } else {
+        return .init()
+      }
+    }(), { () -> bridge.std__optional_std__string_ in
+      if let __unwrappedValue = androidNotificationTitle {
+        return bridge.create_std__optional_std__string_(std.string(__unwrappedValue))
+      } else {
+        return .init()
+      }
+    }(), { () -> bridge.std__optional_std__string_ in
+      if let __unwrappedValue = androidNotificationText {
+        return bridge.create_std__optional_std__string_(std.string(__unwrappedValue))
+      } else {
+        return .init()
+      }
+    }())
+  }
+
+  @inline(__always)
+  var serviceUUIDs: [String] {
+    return self.__serviceUUIDs.map({ __item in String(__item) })
+  }
+  
+  @inline(__always)
+  var localName: String? {
+    return { () -> String? in
+      if bridge.has_value_std__optional_std__string_(self.__localName) {
+        let __unwrapped = bridge.get_std__optional_std__string_(self.__localName)
+        return String(__unwrapped)
+      } else {
+        return nil
+      }
+    }()
+  }
+  
+  @inline(__always)
+  var allowDuplicates: Bool? {
+    return { () -> Bool? in
+      if bridge.has_value_std__optional_bool_(self.__allowDuplicates) {
+        let __unwrapped = bridge.get_std__optional_bool_(self.__allowDuplicates)
+        return __unwrapped
+      } else {
+        return nil
+      }
+    }()
+  }
+  
+  @inline(__always)
+  var scanMode: ScanMode? {
+    return self.__scanMode.value
+  }
+  
+  @inline(__always)
+  var androidNotificationChannelId: String? {
+    return { () -> String? in
+      if bridge.has_value_std__optional_std__string_(self.__androidNotificationChannelId) {
+        let __unwrapped = bridge.get_std__optional_std__string_(self.__androidNotificationChannelId)
+        return String(__unwrapped)
+      } else {
+        return nil
+      }
+    }()
+  }
+  
+  @inline(__always)
+  var androidNotificationChannelName: String? {
+    return { () -> String? in
+      if bridge.has_value_std__optional_std__string_(self.__androidNotificationChannelName) {
+        let __unwrapped = bridge.get_std__optional_std__string_(self.__androidNotificationChannelName)
+        return String(__unwrapped)
+      } else {
+        return nil
+      }
+    }()
+  }
+  
+  @inline(__always)
+  var androidNotificationTitle: String? {
+    return { () -> String? in
+      if bridge.has_value_std__optional_std__string_(self.__androidNotificationTitle) {
+        let __unwrapped = bridge.get_std__optional_std__string_(self.__androidNotificationTitle)
+        return String(__unwrapped)
+      } else {
+        return nil
+      }
+    }()
+  }
+  
+  @inline(__always)
+  var androidNotificationText: String? {
+    return { () -> String? in
+      if bridge.has_value_std__optional_std__string_(self.__androidNotificationText) {
+        let __unwrapped = bridge.get_std__optional_std__string_(self.__androidNotificationText)
+        return String(__unwrapped)
+      } else {
+        return nil
+      }
+    }()
+  }
+}

package/nitrogen/generated/ios/swift/HybridMunimBluetoothSpec.swift

@@ -31,6 +31,8 @@ public protocol HybridMunimBluetoothSpec_protocol: HybridObject {
   func unsubscribeFromCharacteristic(deviceId: String, serviceUUID: String, characteristicUUID: String) throws -> Void
   func getConnectedDevices() throws -> Promise<[String]>
   func readRSSI(deviceId: String) throws -> Promise<Double>
+  func startBackgroundSession(options: BackgroundSessionOptions) throws -> Void
+  func stopBackgroundSession() throws -> Void
   func addListener(eventName: String) throws -> Void
   func removeListeners(count: Double) throws -> Void
 }