feat(ui): exposed additional callkit options (#1138)

* exposed additional callkit options

* removed display name as handle

* tweak

* changelog

Author: Brazol

packages/stream_video/test/src/call/call_test.dart

@@ -155,7 +155,7 @@ void main() {
         );
 
         internetStatusController.add(InternetStatus.disconnected);
-        await Future<void>.delayed(Duration(microseconds: 100));
+        await Future<void>.delayed(Duration.zero);
         internetStatusController.add(InternetStatus.connected);
         await Future<void>.delayed(Duration.zero);
 

packages/stream_video_flutter/CHANGELOG.md

@@ -1,6 +1,15 @@
 ## Upcoming
 
+### ✅ Added
+* Added `includesCallsInRecents` to iOS push configuration to control whether CallKit calls appear in Recents.
+
 ### 🐞 Fixed
+* Improved reconnection reliability:
+  * Added exponential backoff with jitter to fast reconnect attempts.
+  * Fixed fast reconnect deadline check to correctly trigger fallback to rejoin.
+  * Fixed network availability verification during subsequent fast reconnect attempts.
+  * Added `reconnectReason` to reconnect details for sfu logs.
+  * Fixed race condition where automatic ICE restart could interfere with fast reconnect, causing subscriber video to not recover.
 * [iOS] Fixed CallKit event suppression to avoid repeated mute toggle loops.
 
 ## 1.2.2

packages/stream_video_push_notification/CHANGELOG.md

@@ -1,6 +1,9 @@
 ## Upcoming
 
-🐞 Fixed
+### ✅ Added
+* Added `includesCallsInRecents` to iOS push configuration to control whether CallKit calls appear in Recents.
+
+### 🐞 Fixed
 * [iOS] Fixed CallKit event suppression to avoid repeated mute toggle loops.
 
 ## 1.2.2

packages/stream_video_push_notification/ios/stream_video_push_notification/Sources/stream_video_push_notification/StreamVideoPKDelegateManager.swift

@@ -88,6 +88,7 @@ public class StreamVideoPKDelegateManager: NSObject, PKPushRegistryDelegate,
         data.callerName =
             nonEmptyString(callDisplayName) ?? nonEmptyString(createdByName) ?? defaultCallText
         data.handle = createdById ?? defaultCallText
+
         data.type = videoData
         data.extra = ["callCid": callCid]
         data.iconName =

packages/stream_video_push_notification/ios/stream_video_push_notification/Sources/stream_video_push_notification/StreamVideoPushConfiguration.swift

@@ -20,6 +20,7 @@ import Foundation
     @objc public var supportsGrouping: Bool
     @objc public var supportsUngrouping: Bool
     @objc public var ringtonePath: String
+    @objc public var includesCallsInRecents: Bool
 
     @objc public init(headers: NSDictionary) {
         self.headers = headers
@@ -41,6 +42,7 @@ import Foundation
         self.supportsGrouping = true
         self.supportsUngrouping = true
         self.ringtonePath = ""
+        self.includesCallsInRecents = true
     }
 
     @objc public convenience init(args: NSDictionary) {
@@ -76,6 +78,7 @@ import Foundation
             self.supportsGrouping = ios["supportsGrouping"] as? Bool ?? true
             self.supportsUngrouping = ios["supportsUngrouping"] as? Bool ?? true
             self.ringtonePath = ios["ringtonePath"] as? String ?? ""
+            self.includesCallsInRecents = ios["includesCallsInRecents"] as? Bool ?? true
         } else {
             // Fallback to top-level properties if ios object doesn't exist
             self.iconName = args["iconName"] as? String ?? "CallKitLogo"
@@ -96,6 +99,7 @@ import Foundation
             self.supportsGrouping = args["supportsGrouping"] as? Bool ?? true
             self.supportsUngrouping = args["supportsUngrouping"] as? Bool ?? true
             self.ringtonePath = args["ringtonePath"] as? String ?? ""
+            self.includesCallsInRecents = args["includesCallsInRecents"] as? Bool ?? true
         }
     }
 
@@ -117,6 +121,7 @@ import Foundation
             "supportsGrouping": supportsGrouping,
             "supportsUngrouping": supportsUngrouping,
             "ringtonePath": ringtonePath,
+            "includesCallsInRecents": includesCallsInRecents,
         ]
 
         let result: [String: Any] = [

packages/stream_video_push_notification/lib/src/stream_video_push_configuration.dart

@@ -150,6 +150,7 @@ class IOSPushConfiguration {
     this.supportsGrouping,
     this.supportsUngrouping,
     this.ringtonePath,
+    this.includesCallsInRecents,
   });
 
   factory IOSPushConfiguration.fromJson(Map<String, dynamic> json) =>
@@ -158,9 +159,19 @@ class IOSPushConfiguration {
   /// App's Icon. using for display inside Callkit(iOS)
   final String? iconName;
 
-  /// Type handle call `generic`, `number`, `email`
+  /// Type of handle CallKit should expect. The SDK sets the user ID as the
+  /// handle value, so choose the type that matches your user ID format:
+  /// - `generic`: arbitrary identifier (default).
+  /// - `number`: phone-like digits, it's formatted as a number in CallKit.
+  /// - `email`: an email address, it's displayed as an email in CallKit.
   final String? handleType;
+
+  /// When true, wraps callerName/handle/extra into an encrypted JSON blob
+  /// before sending to CallKit. Use this to hide raw IDs,
+  /// but note the visible handle (ex. in Recents) will look like encoded text. Leave
+  /// false for a clean, user-friendly handle string.
   final bool? useComplexHandle;
+
   final bool? supportsVideo;
   final int? maximumCallGroups;
   final int? maximumCallsPerCallGroup;
@@ -177,6 +188,10 @@ class IOSPushConfiguration {
   /// Add file to root project xcode /ios/Runner/Ringtone.caf and Copy Bundle Resources(Build Phases) -> value: "Ringtone.caf"
   final String? ringtonePath;
 
+  /// Whether calls handled by this provider should be included in the system's Recents list.
+  /// Defaults to true. Set to false to prevent calls from appearing in Recents.
+  final bool? includesCallsInRecents;
+
   IOSPushConfiguration copyWith({
     String? iconName,
     String? handleType,
@@ -194,6 +209,7 @@ class IOSPushConfiguration {
     bool? supportsGrouping,
     bool? supportsUngrouping,
     String? ringtonePath,
+    bool? includesCallsInRecents,
   }) {
     return IOSPushConfiguration(
       iconName: iconName ?? this.iconName,
@@ -218,6 +234,8 @@ class IOSPushConfiguration {
       supportsGrouping: supportsGrouping ?? this.supportsGrouping,
       supportsUngrouping: supportsUngrouping ?? this.supportsUngrouping,
       ringtonePath: ringtonePath ?? this.ringtonePath,
+      includesCallsInRecents:
+          includesCallsInRecents ?? this.includesCallsInRecents,
     );
   }
 
@@ -242,6 +260,7 @@ class IOSPushConfiguration {
       supportsGrouping: other.supportsGrouping,
       supportsUngrouping: other.supportsUngrouping,
       ringtonePath: other.ringtonePath,
+      includesCallsInRecents: other.includesCallsInRecents,
     );
   }
 

packages/stream_video_push_notification/lib/src/stream_video_push_configuration.g.dart

@@ -237,6 +237,7 @@ class IOSParams {
     this.supportsGrouping,
     this.supportsUngrouping,
     this.ringtonePath,
+    this.includesCallsInRecents,
   });
 
   factory IOSParams.fromPushConfiguration(IOSPushConfiguration configuration) =>
@@ -259,6 +260,7 @@ class IOSParams {
         supportsGrouping: configuration.supportsGrouping,
         supportsUngrouping: configuration.supportsUngrouping,
         ringtonePath: configuration.ringtonePath,
+        includesCallsInRecents: configuration.includesCallsInRecents,
       );
 
   factory IOSParams.fromJson(Map<String, dynamic> json) =>
@@ -286,6 +288,10 @@ class IOSParams {
   /// Add file to root project xcode /ios/Runner/Ringtone.caf and Copy Bundle Resources(Build Phases) -> value: "Ringtone.caf"
   final String? ringtonePath;
 
+  /// Whether calls handled by this provider should be included in the system's Recents list.
+  /// Defaults to true. Set to false to prevent calls from appearing in Recents.
+  final bool? includesCallsInRecents;
+
   IOSParams copyWith({
     String? iconName,
     String? handleType,
@@ -303,6 +309,7 @@ class IOSParams {
     bool? supportsGrouping,
     bool? supportsUngrouping,
     String? ringtonePath,
+    bool? includesCallsInRecents,
   }) {
     return IOSParams(
       iconName: iconName ?? this.iconName,
@@ -327,6 +334,8 @@ class IOSParams {
       supportsGrouping: supportsGrouping ?? this.supportsGrouping,
       supportsUngrouping: supportsUngrouping ?? this.supportsUngrouping,
       ringtonePath: ringtonePath ?? this.ringtonePath,
+      includesCallsInRecents:
+          includesCallsInRecents ?? this.includesCallsInRecents,
     );
   }
 
@@ -351,6 +360,7 @@ class IOSParams {
       supportsGrouping: other.supportsGrouping,
       supportsUngrouping: other.supportsUngrouping,
       ringtonePath: other.ringtonePath,
+      includesCallsInRecents: other.includesCallsInRecents,
     );
   }