@bubblsdk/react-native-sdk 3.1.6 → 4.0.0

package/BubblReactNativeSdk.podspec

@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name = 'BubblReactNativeSdk'
-  s.version = '3.1.6'
+  s.version = '4.0.0'
   s.summary = 'React Native wrapper for Bubbl SDK v3 native Android and iOS cores.'
   s.homepage = 'https://bubbl.tech'
   s.license = { :type => 'Commercial', :text => 'Copyright Bubbl. All rights reserved.' }
@@ -13,5 +13,5 @@ Pod::Spec.new do |s|
   s.static_framework = true
 
   s.dependency 'React-Core'
-  s.dependency 'BubblSDK', '3.1.6'
+  s.dependency 'BubblSDK', '4.0.0'
 end

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 4.0.0
+
+- Primes iOS native background region monitoring when location tracking starts and after geofence/location refresh calls, so background geofence notifications can fire without relying on foreground JavaScript execution.
+- Adds an iOS launch-options helper so React Native apps can restore persisted SDK state and resume native geofence monitoring before the bridge or JavaScript UI mounts.
+- Aligns the React Native wrapper with the native SDK 4.0.0 release.
+
+## 3.1.7
+
+- Aligns the React Native wrapper with the native SDK 3.1.7 release.
+- Android and iOS default notification modals now embed YouTube media in-app instead of handing off externally.
+
 ## 3.1.6
 
 - Aligns the React Native wrapper with the native SDK 3.1.6 release.

package/README.md

@@ -35,6 +35,21 @@ bundled foreground location service and WorkManager restore/refresh path, and
 iOS uses the bundled CoreLocation monitor. The host app still owns platform
 declarations and runtime permission UX.
 
+For iOS background geofence cold starts, forward launch options from your
+`AppDelegate` before the React Native bridge or JavaScript UI is mounted:
+
+```swift
+import BubblReactNativeSdk
+
+func application(
+  _ application: UIApplication,
+  didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
+) -> Bool {
+  BubblSdkLocationLaunchHandler.handleLaunchOptions(launchOptions as NSDictionary?)
+  return true
+}
+```
+
 For apps that render their own in-app notification modal while still letting
 the native SDK trigger device notifications:
 

package/android/build.gradle

@@ -4,7 +4,7 @@ plugins {
 }
 
 group = "tech.bubbl.reactnative"
-version = "3.1.6"
+version = "4.0.0"
 
 def isNewArchitectureEnabled() {
     project.hasProperty("newArchEnabled") && project.newArchEnabled == "true"
@@ -41,6 +41,6 @@ android {
 
 dependencies {
     implementation "com.facebook.react:react-android:${reactNativeVersion}"
-    implementation "tech.bubbl.sdk:bubbl-sdk:3.1.6"
+    implementation "tech.bubbl.sdk:bubbl-sdk:4.0.0"
     implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.8.1"
 }

package/android/src/main/kotlin/tech/bubbl/reactnative/BubblSdkModule.kt

@@ -35,6 +35,8 @@ import tech.bubbl.sdk.BubblLogLevel
 import tech.bubbl.sdk.BubblNotificationCta
 import tech.bubbl.sdk.BubblNotificationDisplayResult
 import tech.bubbl.sdk.BubblNotificationMedia
+import tech.bubbl.sdk.BubblNotificationModalStyle
+import tech.bubbl.sdk.BubblNotificationModalTheme
 import tech.bubbl.sdk.BubblNotificationPayload
 import tech.bubbl.sdk.BubblNotificationRenderingMode
 import tech.bubbl.sdk.BubblNotificationSource
@@ -172,6 +174,12 @@ class BubblSdkModule(
         null
     }
 
+    @ReactMethod
+    fun setDefaultNotificationModalStyle(style: ReadableMap?, promise: Promise) = resolve(promise) {
+        BubblSdk.setDefaultNotificationModalStyle(style?.toNotificationModalStyle())
+        null
+    }
+
     @ReactMethod
     fun registerPushToken(token: String, promise: Promise) = resolve(promise) {
         BubblSdk.registerPushToken(token)
@@ -288,12 +296,40 @@ class BubblSdkModule(
                 }
             },
             enableDefaultNotificationModal = bool("enableDefaultNotificationModal", true),
+            defaultNotificationModalStyle = map("defaultNotificationModalStyle")?.toNotificationModalStyle(),
             enableDefaultSurveyUi = bool("enableDefaultSurveyUi", true),
             logLevel = enumValue(string("logLevel"), BubblLogLevel.Warn) {
                 BubblLogLevel.valueOf(it.replaceFirstChar(Char::uppercaseChar))
             }
         )
 
+    private fun ReadableMap.toNotificationModalStyle(): BubblNotificationModalStyle =
+        BubblNotificationModalStyle(
+            theme = enumValue(string("theme"), BubblNotificationModalTheme.Light) {
+                if (it == "dark") BubblNotificationModalTheme.Dark else BubblNotificationModalTheme.Light
+            },
+            transparentBackdrop = bool("transparentBackdrop", true),
+            backdropColor = string("backdropColor"),
+            cardBackgroundColor = string("cardBackgroundColor"),
+            cardBorderColor = string("cardBorderColor"),
+            titleColor = string("titleColor"),
+            bodyColor = string("bodyColor"),
+            accentColor = string("accentColor"),
+            iconBackgroundColor = string("iconBackgroundColor"),
+            iconTextColor = string("iconTextColor"),
+            primaryButtonBackgroundColor = string("primaryButtonBackgroundColor"),
+            primaryButtonTextColor = string("primaryButtonTextColor"),
+            secondaryButtonBackgroundColor = string("secondaryButtonBackgroundColor"),
+            secondaryButtonTextColor = string("secondaryButtonTextColor"),
+            textButtonColor = string("textButtonColor"),
+            surveyBackgroundColor = string("surveyBackgroundColor"),
+            inputBackgroundColor = string("inputBackgroundColor"),
+            inputTextColor = string("inputTextColor"),
+            inputBorderColor = string("inputBorderColor"),
+            cornerRadius = nullableDouble("cornerRadius"),
+            buttonCornerRadius = nullableDouble("buttonCornerRadius")
+        )
+
     private fun ReadableMap.toTrackEvent(): BubblTrackEvent =
         BubblTrackEvent(
             type = requiredString("type"),

package/ios/BubblSdk.swift

@@ -1,6 +1,7 @@
 import Foundation
 import React
 import BubblSDK
+import UIKit
 
 #if canImport(CoreLocation)
 import CoreLocation
@@ -114,7 +115,11 @@ final class BubblSdk: RCTEventEmitter {
         reject: @escaping RCTPromiseRejectBlock
     ) {
         resolveAsync(resolve, reject) {
-            try await self.sdk.refreshGeofence(BubblLocation(latitude: latitude, longitude: longitude))
+            let location = BubblLocation(latitude: latitude, longitude: longitude)
+            try await self.sdk.refreshGeofence(location)
+            #if canImport(CoreLocation)
+            await self.locationMonitor.refreshBackgroundRegions(near: location)
+            #endif
             return nil
         }
     }
@@ -127,7 +132,11 @@ final class BubblSdk: RCTEventEmitter {
         reject: @escaping RCTPromiseRejectBlock
     ) {
         resolveAsync(resolve, reject) {
-            try await self.sdk.handleLocationUpdate(BubblLocation(latitude: latitude, longitude: longitude))
+            let location = BubblLocation(latitude: latitude, longitude: longitude)
+            try await self.sdk.handleLocationUpdate(location)
+            #if canImport(CoreLocation)
+            await self.locationMonitor.refreshBackgroundRegions(near: location)
+            #endif
             return nil
         }
     }
@@ -210,6 +219,18 @@ final class BubblSdk: RCTEventEmitter {
         }
     }
 
+    @objc(setDefaultNotificationModalStyle:resolver:rejecter:)
+    func setDefaultNotificationModalStyle(
+        _ style: NSDictionary?,
+        resolve: @escaping RCTPromiseResolveBlock,
+        reject: @escaping RCTPromiseRejectBlock
+    ) {
+        resolveAsync(resolve, reject) {
+            try await self.sdk.setDefaultNotificationModalStyle(try style?.swiftMap.notificationModalStyle())
+            return nil
+        }
+    }
+
     @objc(registerPushToken:resolver:rejecter:)
     func registerPushToken(
         _ token: NSString,
@@ -382,6 +403,31 @@ final class BubblSdk: RCTEventEmitter {
     private static let eventName = "BubblSdkEvent"
 }
 
+@objc(BubblSdkLocationLaunchHandler)
+public final class BubblSdkLocationLaunchHandler: NSObject {
+    #if canImport(CoreLocation)
+    @MainActor private static let locationMonitor = BubblLocationMonitor(sdk: .shared)
+    #endif
+
+    @objc(handleLaunchOptions:)
+    public static func handleLaunchOptions(_ launchOptions: NSDictionary?) -> Bool {
+        let launchedForLocation = launchOptions?[UIApplication.LaunchOptionsKey.location.rawValue] != nil
+            || launchOptions?[UIApplication.LaunchOptionsKey.location] != nil
+
+        guard launchedForLocation else {
+            return false
+        }
+
+        #if canImport(CoreLocation)
+        Task { @MainActor in
+            await locationMonitor.resumeForBackgroundLocationLaunch()
+        }
+        #endif
+
+        return true
+    }
+}
+
 private struct BubblReactNativeError: Error {
     let code: String
     let message: String
@@ -457,11 +503,38 @@ private extension Dictionary where Key == String, Value == Any {
             enableLocationTracking: bool("enableLocationTracking", default: false),
             notificationRenderingMode: BubblNotificationRenderingMode(rawValue: string("notificationRenderingMode") ?? "sdkDefault") ?? .sdkDefault,
             enableDefaultNotificationModal: bool("enableDefaultNotificationModal", default: true),
+            defaultNotificationModalStyle: try map("defaultNotificationModalStyle")?.notificationModalStyle(),
             enableDefaultSurveyUi: bool("enableDefaultSurveyUi", default: true),
             logLevel: BubblLogLevel(rawValue: string("logLevel") ?? "warn") ?? .warn
         )
     }
 
+    func notificationModalStyle() throws -> BubblNotificationModalStyle {
+        BubblNotificationModalStyle(
+            theme: BubblNotificationModalTheme(rawValue: string("theme") ?? "light") ?? .light,
+            transparentBackdrop: bool("transparentBackdrop", default: true),
+            backdropColor: string("backdropColor"),
+            cardBackgroundColor: string("cardBackgroundColor"),
+            cardBorderColor: string("cardBorderColor"),
+            titleColor: string("titleColor"),
+            bodyColor: string("bodyColor"),
+            accentColor: string("accentColor"),
+            iconBackgroundColor: string("iconBackgroundColor"),
+            iconTextColor: string("iconTextColor"),
+            primaryButtonBackgroundColor: string("primaryButtonBackgroundColor"),
+            primaryButtonTextColor: string("primaryButtonTextColor"),
+            secondaryButtonBackgroundColor: string("secondaryButtonBackgroundColor"),
+            secondaryButtonTextColor: string("secondaryButtonTextColor"),
+            textButtonColor: string("textButtonColor"),
+            surveyBackgroundColor: string("surveyBackgroundColor"),
+            inputBackgroundColor: string("inputBackgroundColor"),
+            inputTextColor: string("inputTextColor"),
+            inputBorderColor: string("inputBorderColor"),
+            cornerRadius: optionalDouble("cornerRadius"),
+            buttonCornerRadius: optionalDouble("buttonCornerRadius")
+        )
+    }
+
     func trackEvent() throws -> BubblTrackEvent {
         BubblTrackEvent(
             type: try requiredString("type"),

package/ios/BubblSdkBridge.m

@@ -39,6 +39,9 @@ RCT_EXTERN_METHOD(clearCorrelationId:(RCTPromiseResolveBlock)resolve
 RCT_EXTERN_METHOD(setDefaultNotificationModalEnabled:(BOOL)enabled
                   resolver:(RCTPromiseResolveBlock)resolve
                   rejecter:(RCTPromiseRejectBlock)reject)
+RCT_EXTERN_METHOD(setDefaultNotificationModalStyle:(NSDictionary *)style
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
 RCT_EXTERN_METHOD(registerPushToken:(NSString *)token
                   resolver:(RCTPromiseResolveBlock)resolve
                   rejecter:(RCTPromiseRejectBlock)reject)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bubblsdk/react-native-sdk",
-  "version": "3.1.6",
+  "version": "4.0.0",
   "description": "React Native wrapper for Bubbl SDK v3 native Android and iOS cores.",
   "main": "src/index.ts",
   "module": "src/index.ts",

package/src/index.ts

@@ -9,6 +9,31 @@ export type BubblEnvironment = 'development' | 'staging' | 'production';
 export type BubblLogLevel = 'off' | 'error' | 'warn' | 'info' | 'debug';
 export type BubblNotificationRenderingMode = 'sdkDefault' | 'hostRendered' | 'eventOnly';
 export type BubblNotificationSource = 'firebase' | 'apns' | 'runtime' | 'geofence' | 'manual';
+export type BubblNotificationModalTheme = 'light' | 'dark';
+
+export type BubblNotificationModalStyle = {
+  theme?: BubblNotificationModalTheme;
+  transparentBackdrop?: boolean;
+  backdropColor?: string | null;
+  cardBackgroundColor?: string | null;
+  cardBorderColor?: string | null;
+  titleColor?: string | null;
+  bodyColor?: string | null;
+  accentColor?: string | null;
+  iconBackgroundColor?: string | null;
+  iconTextColor?: string | null;
+  primaryButtonBackgroundColor?: string | null;
+  primaryButtonTextColor?: string | null;
+  secondaryButtonBackgroundColor?: string | null;
+  secondaryButtonTextColor?: string | null;
+  textButtonColor?: string | null;
+  surveyBackgroundColor?: string | null;
+  inputBackgroundColor?: string | null;
+  inputTextColor?: string | null;
+  inputBorderColor?: string | null;
+  cornerRadius?: number | null;
+  buttonCornerRadius?: number | null;
+};
 
 export type BubblConfig = {
   apiKey: string;
@@ -24,6 +49,7 @@ export type BubblConfig = {
   enableLocationTracking?: boolean;
   notificationRenderingMode?: BubblNotificationRenderingMode;
   enableDefaultNotificationModal?: boolean;
+  defaultNotificationModalStyle?: BubblNotificationModalStyle | null;
   enableDefaultSurveyUi?: boolean;
   logLevel?: BubblLogLevel;
 };
@@ -237,6 +263,12 @@ export const Bubbl = {
   async setDefaultNotificationModalEnabled(enabled: boolean): Promise<void> {
     return nativeModule().setDefaultNotificationModalEnabled(enabled);
   },
+  async setDefaultNotificationModalStyle(style: BubblNotificationModalStyle | null): Promise<void> {
+    return nativeModule().setDefaultNotificationModalStyle(style);
+  },
+  async resetDefaultNotificationModalStyle(): Promise<void> {
+    return nativeModule().setDefaultNotificationModalStyle(null);
+  },
   async disableDefaultNotificationModal(): Promise<void> {
     return nativeModule().setDefaultNotificationModalEnabled(false);
   },

package/src/specs/NativeBubblSdk.ts

@@ -15,6 +15,7 @@ export type BubblBootOptions = {
   enableLocationTracking?: boolean;
   notificationRenderingMode?: string;
   enableDefaultNotificationModal?: boolean;
+  defaultNotificationModalStyle?: Object | null;
   enableDefaultSurveyUi?: boolean;
   logLevel?: string;
 };
@@ -34,6 +35,7 @@ export interface Spec extends TurboModule {
   setCorrelationId(value: string): Promise<void>;
   clearCorrelationId(): Promise<void>;
   setDefaultNotificationModalEnabled(enabled: boolean): Promise<void>;
+  setDefaultNotificationModalStyle(style?: Object | null): Promise<void>;
   registerPushToken(token: string): Promise<void>;
   handleFirebasePayload(payload: Object): Promise<Object | null>;
   showNotification(payload: Object): Promise<Object>;