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

package/CHANGELOG.md

@@ -1,6 +1,10 @@
 # Changelog
 
-## Unreleased
+## 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.
+
+## 5.0.0-alpha.1
 
 - New v5 wrapper, replacing the 4.x one: a TurboModule (React Native 0.76+, New Architecture)
   with the public API of docs/PUBLIC_API.md — `start(apiKey, options)`, consent and privacy,

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.1"
+    implementation "tech.bubbl.sdk:bubbl-sdk:5.0.0-alpha.2"
 }

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.1"
+    package static let sdk = "5.0.0-alpha.2"
 }

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.1"
+    package static let sdk = "5.0.0-alpha.2"
 }

package/ios-sdk/BubblSDK/Bubbl.swift

@@ -12,8 +12,8 @@ import BubblCore
 ///
 ///     Bubbl.start(apiKey: "pk_live_…", options: BubblOptions(baseUrl: "https://…"))
 ///
-/// Every call is safe from any thread. Calls before `start` do nothing (and log a warning). Bubbl
-/// never stops the app: a mistake (an empty key, an http:// URL) is logged, not thrown.
+/// Every call is safe from any thread. Calls before `start` do nothing (and log a warning), except
+/// `permissions.openSettings()`, which needs nothing of Bubbl's. Bubbl never stops the app: a mistake (an empty key, an http:// URL) is logged, not thrown.
 ///
 /// Bubbl works on iOS 17 and later. An app supporting older versions can still include it: on
 /// those phones `isSupported` is false and every call does nothing (see `isSupported`).

package/ios-sdk/BubblSDK/BubblPermissions.swift

@@ -66,7 +66,9 @@ public struct BubblPermissions: Sendable {
         }
     }
 
-    /// The app's page in the system's Settings.
+    /// The app's page in the system's Settings, for a permission the user refused (one of the app's
+    /// own, like the camera, too). Works before `Bubbl.start`: it needs nothing of Bubbl's. Opens on
+    /// the main thread, whichever thread this is called from.
     public func openSettings() {
         Bubbl.backend.openSettings()
     }

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

@@ -229,9 +229,11 @@ struct SupportedBubbl: BubblBackend {
         #endif
     }
 
+    /// No engine needed, so no `start` check: an app can send the user to its settings page before
+    /// starting Bubbl.
     func openSettings() {
         #if os(iOS)
-        Task { @MainActor in PermissionFlow.shared.openSettings() }
+        Task { @MainActor in PermissionFlow.openSettings() }
         #endif
     }
 

package/ios-sdk/BubblSDK/Permissions/PermissionFlow.swift

@@ -89,7 +89,9 @@ final class PermissionFlow: NSObject, CLLocationManagerDelegate {
         }
     }
 
-    func openSettings() {
+    /// Static: opening the app's settings page needs none of the flow's state (no location manager),
+    /// so it can run before `Bubbl.start`.
+    static func openSettings() {
         guard let url = URL(string: UIApplication.openSettingsURLString) else { return }
         UIApplication.shared.open(url)
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bubblsdk/react-native-sdk",
-  "version": "5.0.0-alpha.1",
+  "version": "5.0.0-alpha.2",
   "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",