voltra 1.3.1 → 1.4.0

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # voltra
 
+## 1.4.0
+
+### Minor Changes
+
+- Android home-screen widgets can use colors that follow the user’s theme and wallpaper (including Material You), so widgets feel native in light, dark, and dynamic setups. If you drive widgets from your own server, you can read the full request URL—including query parameters—when handling updates, which makes it easier to personalize or A/B content per link. Widget updates on iOS are a bit more forgiving when variant data is missing.
+- 14d4fa5: Add Android ongoing notification support, including richer notification content, remote update flows, and server-side payload rendering APIs. This release also expands the Expo integration and documentation so apps can configure, send, and manage Android ongoing notifications more easily.
+
+### Patch Changes
+
+- Android apps built for production (minified / release) are less likely to crash or mis-render widgets because of how widget payloads are processed on the device.
+- 8cedb47: Fix iOS Live Activity naming so named activities can be reused more reliably across app launches.
+- Work on decomposing Voltra into smaller packages continues, and more pieces have moved from the umbrella package into the respective `@use-voltra/*` packages. You should still use the `voltra` umbrella for your app.
+- Updated dependencies
+- Updated dependencies [14d4fa5]
+- Updated dependencies
+  - @use-voltra/android@1.4.0
+  - @use-voltra/android-server@1.4.0
+  - @use-voltra/ios-server@1.3.2
+  - @use-voltra/server@1.4.0
+  - @use-voltra/expo-plugin@1.4.0
+  - @use-voltra/android-client@1.4.0
+  - @use-voltra/core@1.4.0
+  - @use-voltra/ios@1.4.0
+  - @use-voltra/ios-client@1.4.0
+
 ## 1.3.0
 
 ### Patch Changes

package/android/build.gradle

@@ -102,9 +102,6 @@ dependencies {
   // Google Tink (encryption for credential storage)
   implementation "com.google.crypto.tink:tink-android:1.19.0"
 
-  // JSON parsing
-  implementation "com.google.code.gson:gson:2.10.1"
-
   // Coroutines
   implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.8.1"
 
@@ -114,4 +111,5 @@ dependencies {
   // Unit tests
   testImplementation "junit:junit:4.13.2"
   testImplementation "org.jetbrains.kotlinx:kotlinx-coroutines-test:1.8.1"
+  testImplementation "org.robolectric:robolectric:4.14.1"
 }

package/android/src/main/AndroidManifest.xml

@@ -1,6 +1,4 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
-    <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
-
     <application>
         <provider
             android:name="androidx.core.content.FileProvider"
@@ -12,4 +10,4 @@
                 android:resource="@xml/voltra_file_paths" />
         </provider>
     </application>
-</manifest>
+</manifest>

package/android/src/main/java/voltra/VoltraModule.kt

@@ -67,54 +67,151 @@ class VoltraModule : Module() {
                 eventBusUnsubscribe = null
             }
 
-            // Android Live Update APIs
+            // Android ongoing notification APIs
 
-            AsyncFunction("startAndroidLiveUpdate") {
+            AsyncFunction("startAndroidOngoingNotification") {
                 payload: String,
                 options: Map<String, Any?>,
                 ->
 
-                Log.d(TAG, "startAndroidLiveUpdate called")
+                Log.d(TAG, "startAndroidOngoingNotification called")
 
-                val updateName = options["updateName"] as? String
-                val channelId = options["channelId"] as? String ?: "voltra_live_updates"
-
-                Log.d(TAG, "updateName=$updateName, channelId=$channelId")
+                val ongoingNotificationOptions =
+                    AndroidOngoingNotificationOptions(
+                        notificationId = options["notificationId"] as? String,
+                        channelId = options["channelId"] as? String,
+                        smallIcon = options["smallIcon"] as? String,
+                        deepLinkUrl = options["deepLinkUrl"] as? String,
+                        requestPromotedOngoing = options["requestPromotedOngoing"] as? Boolean,
+                        fallbackBehavior = options["fallbackBehavior"] as? String,
+                    )
 
                 val result =
                     runBlocking {
-                        notificationManager.startLiveUpdate(payload, updateName, channelId)
+                        notificationManager.startOngoingNotification(payload, ongoingNotificationOptions)
                     }
 
-                Log.d(TAG, "startAndroidLiveUpdate returning: $result")
-                result
+                Log.d(TAG, "startAndroidOngoingNotification returning: $result")
+                mapOf(
+                    "ok" to result.ok,
+                    "notificationId" to result.notificationId,
+                    "action" to result.action,
+                    "reason" to result.reason,
+                )
             }
 
-            AsyncFunction("updateAndroidLiveUpdate") {
+            AsyncFunction("updateAndroidOngoingNotification") {
                 notificationId: String,
                 payload: String,
+                options: Map<String, Any?>?,
                 ->
 
-                Log.d(TAG, "updateAndroidLiveUpdate called with notificationId=$notificationId")
+                Log.d(TAG, "updateAndroidOngoingNotification called with notificationId=$notificationId")
 
-                runBlocking {
-                    notificationManager.updateLiveUpdate(notificationId, payload)
-                }
+                val ongoingNotificationOptions =
+                    AndroidOngoingNotificationOptions(
+                        channelId = options?.get("channelId") as? String,
+                        smallIcon = options?.get("smallIcon") as? String,
+                        deepLinkUrl = options?.get("deepLinkUrl") as? String,
+                        requestPromotedOngoing = options?.get("requestPromotedOngoing") as? Boolean,
+                        fallbackBehavior = options?.get("fallbackBehavior") as? String,
+                    )
+
+                val result =
+                    runBlocking {
+                        notificationManager.updateOngoingNotification(
+                            notificationId,
+                            payload,
+                            ongoingNotificationOptions,
+                        )
+                    }
+
+                Log.d(TAG, "updateAndroidOngoingNotification returning: $result")
+                mapOf(
+                    "ok" to result.ok,
+                    "notificationId" to result.notificationId,
+                    "action" to result.action,
+                    "reason" to result.reason,
+                )
+            }
+
+            AsyncFunction("upsertAndroidOngoingNotification") {
+                payload: String,
+                options: Map<String, Any?>,
+                ->
+
+                Log.d(TAG, "upsertAndroidOngoingNotification called")
+
+                val ongoingNotificationOptions =
+                    AndroidOngoingNotificationOptions(
+                        notificationId = options["notificationId"] as? String,
+                        channelId = options["channelId"] as? String,
+                        smallIcon = options["smallIcon"] as? String,
+                        deepLinkUrl = options["deepLinkUrl"] as? String,
+                        requestPromotedOngoing = options["requestPromotedOngoing"] as? Boolean,
+                        fallbackBehavior = options["fallbackBehavior"] as? String,
+                    )
+
+                val result =
+                    runBlocking {
+                        notificationManager.upsertOngoingNotification(payload, ongoingNotificationOptions)
+                    }
+
+                Log.d(TAG, "upsertAndroidOngoingNotification returning: $result")
+                mapOf(
+                    "ok" to result.ok,
+                    "notificationId" to result.notificationId,
+                    "action" to result.action,
+                    "reason" to result.reason,
+                )
+            }
+
+            AsyncFunction("stopAndroidOngoingNotification") { notificationId: String ->
+                Log.d(TAG, "stopAndroidOngoingNotification called with notificationId=$notificationId")
+                val result = notificationManager.stopOngoingNotification(notificationId)
+                mapOf(
+                    "ok" to result.ok,
+                    "notificationId" to result.notificationId,
+                    "action" to result.action,
+                    "reason" to result.reason,
+                )
+            }
+
+            Function("isAndroidOngoingNotificationActive") { notificationId: String ->
+                notificationManager.isOngoingNotificationActive(notificationId)
+            }
+
+            Function("getAndroidOngoingNotificationStatus") { notificationId: String ->
+                val status = notificationManager.getOngoingNotificationStatus(notificationId)
+                mapOf(
+                    "isActive" to status.isActive,
+                    "isDismissed" to status.isDismissed,
+                    "isPromoted" to status.isPromoted,
+                    "hasPromotableCharacteristics" to status.hasPromotableCharacteristics,
+                )
+            }
 
-                Log.d(TAG, "updateAndroidLiveUpdate completed")
+            AsyncFunction("endAllAndroidOngoingNotifications") {
+                notificationManager.endAllOngoingNotifications()
             }
 
-            AsyncFunction("stopAndroidLiveUpdate") { notificationId: String ->
-                Log.d(TAG, "stopAndroidLiveUpdate called with notificationId=$notificationId")
-                notificationManager.stopLiveUpdate(notificationId)
+            Function("canPostPromotedAndroidNotifications") {
+                notificationManager.canPostPromotedAndroidNotifications()
             }
 
-            Function("isAndroidLiveUpdateActive") { updateName: String ->
-                notificationManager.isLiveUpdateActive(updateName)
+            Function("getAndroidOngoingNotificationCapabilities") {
+                val capabilities = notificationManager.getOngoingNotificationCapabilities()
+                mapOf(
+                    "apiLevel" to capabilities.apiLevel,
+                    "notificationsEnabled" to capabilities.notificationsEnabled,
+                    "supportsPromotedNotifications" to capabilities.supportsPromotedNotifications,
+                    "canPostPromotedNotifications" to capabilities.canPostPromotedNotifications,
+                    "canRequestPromotedOngoing" to capabilities.canRequestPromotedOngoing,
+                )
             }
 
-            AsyncFunction("endAllAndroidLiveUpdates") {
-                notificationManager.endAllLiveUpdates()
+            AsyncFunction("openAndroidNotificationSettings") {
+                notificationManager.openPromotedNotificationSettings()
             }
 
             // Android Widget APIs