@bubblsdk/react-native-sdk 5.0.0-alpha.2 → 5.0.0-alpha.3

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 5.0.0-alpha.3
+
+- Silent geofence sync: the backend now dispatches a silent push when a geo campaign is published,
+  updated, or paused. The SDK wakes in the background, fetches the latest geofences, and registers
+  them with the OS — so devices receive notifications even if the app has never been opened in that
+  area. Requires `remote-notification` in `UIBackgroundModes` on iOS (already present in most
+  Bubbl-enabled apps).
+
 ## 5.0.0-alpha.2
 
 - `Bubbl.permissions.openSettings()` now works before `Bubbl.start` on Android, so an app can send people to its settings page (for example after a camera refusal) before it starts Bubbl. iOS 17+ already did. Below the minimum OS it stays a no-op.

package/android/build.gradle

@@ -45,5 +45,5 @@ repositories {
 dependencies {
     implementation "com.facebook.react:react-android"
     // The Bubbl Android SDK, the same version as this package (stamped by scripts/sync-version.mjs).
-    implementation "tech.bubbl.sdk:bubbl-sdk:5.0.0-alpha.2"
+    implementation "tech.bubbl.sdk:bubbl-sdk:5.0.0-alpha.3"
 }

package/ios/BubblPush.swift

@@ -1,7 +1,10 @@
 import Foundation
+#if canImport(UIKit)
+import UIKit
+#endif
 import UserNotifications
 
-/// The iOS SDK's three push hand-overs for an app with `BubblAutoIntegrationEnabled` = NO in
+/// The iOS SDK's push hand-overs for an app with `BubblAutoIntegrationEnabled` = NO in
 /// Info.plist, callable from an Objective-C AppDelegate too (the SDK's `Bubbl` is Swift only).
 /// From Swift, `import BubblReactNativeSdk` and call `Bubbl.setPushToken(_:)` and the rest
 /// directly; from Objective-C:
@@ -12,6 +15,7 @@ import UserNotifications
 ///     [BubblPush setPushToken:deviceToken];
 ///     if ([BubblPush willPresent:notification completionHandler:completionHandler]) return;
 ///     if ([BubblPush didReceive:response completionHandler:completionHandler]) return;
+///     if ([BubblPush didReceiveRemoteNotification:userInfo completionHandler:completionHandler]) return;
 @objc(BubblPush)
 public final class BubblPush: NSObject {
     /// From `application(_:didRegisterForRemoteNotificationsWithDeviceToken:)`. Before start too.
@@ -37,6 +41,16 @@ public final class BubblPush: NSObject {
         Bubbl.didReceive(response, completionHandler: completionHandler)
     }
 
+    /// From `application(_:didReceiveRemoteNotification:fetchCompletionHandler:)`: true when the
+    /// remote notification is Bubbl's, and Bubbl calls `completionHandler`; false when it isn't.
+    @discardableResult
+    @objc public static func didReceiveRemoteNotification(
+        _ userInfo: [AnyHashable: Any],
+        completionHandler: @escaping (UIBackgroundFetchResult) -> Void
+    ) -> Bool {
+        Bubbl.didReceiveRemoteNotification(userInfo, completionHandler: completionHandler)
+    }
+
     /// Whether a push's payload is Bubbl's, so the app's own handling can leave it alone.
     @objc public static func isBubblMessage(_ userInfo: [AnyHashable: Any]) -> Bool {
         Bubbl.isBubblMessage(userInfo)

package/ios-extension/Sources/BubblCore/BubblVersion.swift

@@ -1,5 +1,5 @@
 /// The SDK's version, sent as X-Bubbl-SDK-Version. Stamped from version.txt by
 /// scripts/sync-version.mjs; don't edit it by hand.
 package enum BubblVersion {
-    package static let sdk = "5.0.0-alpha.2"
+    package static let sdk = "5.0.0-alpha.3"
 }

package/ios-extension/Sources/BubblCore/Engine/Pushes.swift

@@ -28,7 +28,7 @@ extension EngineCore {
         switch message {
         case .test(let title, let body):
             return .test(title: title, body: body)
-        case .unsupported:
+        case .syncGeofences, .unsupported:
             return .nothing
         case .full(_, let notification):
             return await notificationArrived(notification, opened: opened)

package/ios-extension/Sources/BubblCore/Notification/Push.swift

@@ -11,12 +11,14 @@ package enum PushMessage: Sendable, Equatable {
     case reference(campaignNotificationId: String)
     /// A dashboard test push: no campaign behind it, so nothing to fetch or report.
     case test(title: String, body: String)
+    /// A silent push asking the SDK to sync geofences in the background.
+    case syncGeofences
     /// Bubbl's, but not something this SDK can show (a newer format): not the app's to handle either.
     case unsupported(version: String)
 
     package static let version = "1"
     /// The data keys a Bubbl push carries (push.json).
-    package static let keys = ["bubbl", "bubbl_v", "campaign_notification_id", "notification", "test", "title", "body", "image_url"]
+    package static let keys = ["bubbl", "bubbl_v", "action", "campaign_notification_id", "notification", "test", "title", "body", "image_url"]
 
     /// The picture for the system notification (image_url), for the notification service
     /// extension: there even when the notification itself was too big to come in the push. Only
@@ -43,6 +45,9 @@ package enum PushMessage: Sendable, Equatable {
             BubblLog.warning("A push in data format \(version) was left alone: this SDK reads format \(Self.version)")
             return .unsupported(version: version)
         }
+        if data["action"]?.stringValue == "sync_geofences" {
+            return .syncGeofences
+        }
         if isSet(data["test"]) {
             return .test(title: data["title"]?.stringValue ?? "", body: data["body"]?.stringValue ?? "")
         }

package/ios-sdk/BubblCore/BubblVersion.swift

@@ -1,5 +1,5 @@
 /// The SDK's version, sent as X-Bubbl-SDK-Version. Stamped from version.txt by
 /// scripts/sync-version.mjs; don't edit it by hand.
 package enum BubblVersion {
-    package static let sdk = "5.0.0-alpha.2"
+    package static let sdk = "5.0.0-alpha.3"
 }

package/ios-sdk/BubblCore/Engine/Pushes.swift

@@ -28,7 +28,7 @@ extension EngineCore {
         switch message {
         case .test(let title, let body):
             return .test(title: title, body: body)
-        case .unsupported:
+        case .syncGeofences, .unsupported:
             return .nothing
         case .full(_, let notification):
             return await notificationArrived(notification, opened: opened)

package/ios-sdk/BubblCore/Notification/Push.swift

@@ -11,12 +11,14 @@ package enum PushMessage: Sendable, Equatable {
     case reference(campaignNotificationId: String)
     /// A dashboard test push: no campaign behind it, so nothing to fetch or report.
     case test(title: String, body: String)
+    /// A silent push asking the SDK to sync geofences in the background.
+    case syncGeofences
     /// Bubbl's, but not something this SDK can show (a newer format): not the app's to handle either.
     case unsupported(version: String)
 
     package static let version = "1"
     /// The data keys a Bubbl push carries (push.json).
-    package static let keys = ["bubbl", "bubbl_v", "campaign_notification_id", "notification", "test", "title", "body", "image_url"]
+    package static let keys = ["bubbl", "bubbl_v", "action", "campaign_notification_id", "notification", "test", "title", "body", "image_url"]
 
     /// The picture for the system notification (image_url), for the notification service
     /// extension: there even when the notification itself was too big to come in the push. Only
@@ -43,6 +45,9 @@ package enum PushMessage: Sendable, Equatable {
             BubblLog.warning("A push in data format \(version) was left alone: this SDK reads format \(Self.version)")
             return .unsupported(version: version)
         }
+        if data["action"]?.stringValue == "sync_geofences" {
+            return .syncGeofences
+        }
         if isSet(data["test"]) {
             return .test(title: data["title"]?.stringValue ?? "", body: data["body"]?.stringValue ?? "")
         }

package/ios-sdk/BubblSDK/Bubbl.swift

@@ -1,4 +1,7 @@
 import Foundation
+#if canImport(UIKit)
+import UIKit
+#endif
 #if canImport(UserNotifications)
 import UserNotifications
 #endif
@@ -222,6 +225,14 @@ public enum Bubbl {
     public static func didReceive(_ response: UNNotificationResponse, completionHandler: @escaping () -> Void) -> Bool {
         backend.didReceive(response, completionHandler: completionHandler)
     }
+
+    /// From the app delegate's `application(_:didReceiveRemoteNotification:fetchCompletionHandler:)`:
+    /// true when the remote notification is Bubbl's, and Bubbl calls `completionHandler`; false when it
+    /// isn't.
+    @discardableResult
+    public static func didReceiveRemoteNotification(_ userInfo: [AnyHashable: Any], completionHandler: @escaping (UIBackgroundFetchResult) -> Void) -> Bool {
+        backend.didReceiveRemoteNotification(userInfo, completionHandler: completionHandler)
+    }
     #endif
 
     // MARK: - Diagnostics

package/ios-sdk/BubblSDK/BubblBackend.swift

@@ -1,5 +1,8 @@
 import Foundation
 import os
+#if canImport(UIKit)
+import UIKit
+#endif
 #if canImport(UserNotifications)
 import UserNotifications
 #endif
@@ -40,6 +43,7 @@ protocol BubblBackend: Sendable {
     func setPushToken(_ deviceToken: Data)
     func willPresent(_ notification: UNNotification, completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) -> Bool
     func didReceive(_ response: UNNotificationResponse, completionHandler: @escaping () -> Void) -> Bool
+    func didReceiveRemoteNotification(_ userInfo: [AnyHashable: Any], completionHandler: @escaping (UIBackgroundFetchResult) -> Void) -> Bool
     #endif
 
     func permissionStatus() -> BubblPermissionStatus?
@@ -94,6 +98,7 @@ struct UnsupportedBubbl: BubblBackend {
     func setPushToken(_ deviceToken: Data) {}
     func willPresent(_ notification: UNNotification, completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) -> Bool { false }
     func didReceive(_ response: UNNotificationResponse, completionHandler: @escaping () -> Void) -> Bool { false }
+    func didReceiveRemoteNotification(_ userInfo: [AnyHashable: Any], completionHandler: @escaping (UIBackgroundFetchResult) -> Void) -> Bool { false }
     #endif
 
     func permissionStatus() -> BubblPermissionStatus? { nil }

package/ios-sdk/BubblSDK/Engine/EngineHost+Push.swift

@@ -1,4 +1,7 @@
 import Foundation
+#if canImport(UIKit)
+import UIKit
+#endif
 #if canImport(UserNotifications)
 import UserNotifications
 #endif
@@ -151,4 +154,33 @@ extension EngineHost {
             break
         }
     }
+
+    #if os(iOS)
+    /// A remote notification arrived via application(_:didReceiveRemoteNotification:fetchCompletionHandler:).
+    /// Returns the UIBackgroundFetchResult to hand iOS's completion handler.
+    func receivedRemoteNotification(_ data: [String: JSONValue]) async -> UIBackgroundFetchResult {
+        if current == nil {
+            applicationDidFinishLaunching()
+        }
+        guard let core = current, core.isActive else { return .noData }
+
+        guard let message = PushMessage.parse(data) else { return .noData }
+        switch message {
+        case .syncGeofences:
+            BubblLog.info("Silent push received: syncing geofences")
+            let outcome = await runCheck(core, force: true, precise: false, rewatch: false, fix: nil)
+            switch outcome {
+            case .done:
+                return .newData
+            case .retry:
+                return .failed
+            }
+        case .full, .reference:
+            _ = await presentation(forArriving: data)
+            return .newData
+        case .test, .unsupported:
+            return .noData
+        }
+    }
+    #endif
 }

package/ios-sdk/BubblSDK/Engine/SupportedBubbl.swift

@@ -208,6 +208,10 @@ struct SupportedBubbl: BubblBackend {
     func didReceive(_ response: UNNotificationResponse, completionHandler: @escaping () -> Void) -> Bool {
         NotificationDelegateHooks.didReceive(response, completionHandler)
     }
+
+    func didReceiveRemoteNotification(_ userInfo: [AnyHashable: Any], completionHandler: @escaping (UIBackgroundFetchResult) -> Void) -> Bool {
+        PushIntegration.didReceiveRemoteNotification(userInfo, completionHandler)
+    }
     #endif
 
     // MARK: - Permissions

package/ios-sdk/BubblSDK/Platform/LocationService.swift

@@ -196,7 +196,7 @@ final class LocationService: NSObject, CLLocationManagerDelegate {
         }
 
         oneShot.desiredAccuracy = precise ? kCLLocationAccuracyBest : kCLLocationAccuracyHundredMeters
-        return await withCheckedContinuation { continuation in
+        let fresh: Fix? = await withCheckedContinuation { continuation in
             waiting.append(continuation)
             guard waiting.count == 1 else { return }
             fixRequest += 1
@@ -207,6 +207,16 @@ final class LocationService: NSObject, CLLocationManagerDelegate {
                 if self.fixRequest == request { self.deliver(nil) }
             }
         }
+        if let fresh { return fresh }
+
+        // When a fresh fix couldn't be obtained in time (e.g. indoors or during a background wake-up),
+        // fall back to the most recent cached location if available, as Android does with fused.lastLocation.
+        let candidates = [oneShot.location, inUse.location, changes.location].compactMap { $0 }
+        if let mostRecent = candidates.max(by: { $0.timestamp < $1.timestamp }) {
+            BubblLog.debug("Geofence check: using cached location from \(-Int(mostRecent.timestamp.timeIntervalSinceNow))s ago")
+            return Fix(mostRecent)
+        }
+        return nil
     }
 
     /// While the app is open and iOS isn't watching the geofences: fixes every 20 m or so.

package/ios-sdk/BubblSDK/Platform/PushIntegration.swift

@@ -80,6 +80,18 @@ enum PushIntegration {
             await MainActor.run { UIApplication.shared.registerForRemoteNotifications() }
         }
     }
+
+    /// Bubbl answers for a remote notification (e.g. background geofence sync push); false when it isn't Bubbl's.
+    static func didReceiveRemoteNotification(_ userInfo: [AnyHashable: Any], _ completion: @escaping (UIBackgroundFetchResult) -> Void) -> Bool {
+        let data = EngineHost.pushData(userInfo)
+        guard PushMessage.isBubbl(data) else { return false }
+        let done = Handed(completion)
+        Task { @MainActor in
+            let result = await EngineHost.shared.receivedRemoteNotification(data)
+            done.value(result)
+        }
+        return true
+    }
 }
 
 // MARK: - The app delegate's token callbacks
@@ -88,6 +100,7 @@ enum PushIntegration {
 enum AppDelegateHooks {
     private typealias DidRegister = @convention(c) (AnyObject, Selector, UIApplication, NSData) -> Void
     private typealias DidFail = @convention(c) (AnyObject, Selector, UIApplication, NSError) -> Void
+    private typealias DidReceiveRemote = @convention(c) (AnyObject, Selector, UIApplication, NSDictionary, @escaping @convention(block) (UIBackgroundFetchResult) -> Void) -> Void
 
     @MainActor
     static func install() {
@@ -123,6 +136,29 @@ enum AppDelegateHooks {
             }
             return block
         }
+
+        let didReceiveRemote = #selector(UIApplicationDelegate.application(_:didReceiveRemoteNotification:fetchCompletionHandler:))
+        Swizzle.extend(cls, didReceiveRemote, types: "v@:@@@?") { original in
+            let block: @convention(block) (AnyObject, UIApplication, NSDictionary, @escaping @convention(block) (UIBackgroundFetchResult) -> Void) -> Void = { this, application, userInfo, completion in
+                let dict = userInfo as? [AnyHashable: Any] ?? [:]
+                if PushIntegration.didReceiveRemoteNotification(dict, completion) { return }
+                if let original {
+                    unsafeBitCast(original, to: DidReceiveRemote.self)(this, didReceiveRemote, application, userInfo, completion)
+                } else if let target = Swizzle.forwardee(this, didReceiveRemote) {
+                    if let delegate = target as? UIApplicationDelegate {
+                        delegate.application?(application, didReceiveRemoteNotification: dict, fetchCompletionHandler: completion)
+                    } else if let method = class_getInstanceMethod(object_getClass(target), didReceiveRemote) {
+                        let imp = method_getImplementation(method)
+                        unsafeBitCast(imp, to: DidReceiveRemote.self)(target, didReceiveRemote, application, userInfo, completion)
+                    } else {
+                        completion(.noData)
+                    }
+                } else {
+                    completion(.noData)
+                }
+            }
+            return block
+        }
     }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bubblsdk/react-native-sdk",
-  "version": "5.0.0-alpha.2",
+  "version": "5.0.0-alpha.3",
   "description": "Bubbl for React Native: geofenced and scheduled notifications, surveys and analytics, over the native Bubbl SDKs.",
   "main": "./lib/commonjs/index.js",
   "module": "./lib/module/index.js",