[AND-207] Simplify notification overriding for customization (#1265)

* 1. Expose the PendingIntent getters for different types of calls as public APIs.
2. Mark intentResolver with public visibility

* change method visibility to open for enhanced notification customization

Updated visibility of private and default methods to open to allow further extension and customization of notifications.

This change provides greater flexibility for users to override and tailor notification behavior according to their specific needs.

---------

Co-authored-by: Aleksandar Apostolov <apostolov.alexandar@gmail.com>

Author: rahul-lohra

stream-video-android-core/api/stream-video-android-core.api

@@ -4335,16 +4335,29 @@ public class io/getstream/video/android/core/notifications/DefaultNotificationHa
 	public static final field Companion Lio/getstream/video/android/core/notifications/DefaultNotificationHandler$Companion;
 	public fun <init> (Landroid/app/Application;Lio/getstream/android/push/permissions/NotificationPermissionHandler;ZI)V
 	public synthetic fun <init> (Landroid/app/Application;Lio/getstream/android/push/permissions/NotificationPermissionHandler;ZIILkotlin/jvm/internal/DefaultConstructorMarker;)V
+	public fun addCallActions (Landroidx/core/app/NotificationCompat$Builder;Landroid/app/PendingIntent;Landroid/app/PendingIntent;Ljava/lang/String;)Landroidx/core/app/NotificationCompat$Builder;
+	public fun addHangUpAction (Landroidx/core/app/NotificationCompat$Builder;Landroid/app/PendingIntent;Ljava/lang/String;I)Landroidx/core/app/NotificationCompat$Builder;
+	public fun createIncomingCallChannel (Ljava/lang/String;Z)V
+	public fun createOnGoingChannel (Ljava/lang/String;)V
+	public fun getAcceptAction (Landroid/app/PendingIntent;)Landroidx/core/app/NotificationCompat$Action;
 	public fun getChannelDescription ()Ljava/lang/String;
 	public fun getChannelId ()Ljava/lang/String;
 	public fun getChannelName ()Ljava/lang/String;
 	public final fun getHideRingingNotificationInForeground ()Z
+	public fun getIncomingCallNotification (Landroid/app/PendingIntent;Landroid/app/PendingIntent;Landroid/app/PendingIntent;Ljava/lang/String;Z)Landroid/app/Notification;
+	public final fun getIntentResolver ()Lio/getstream/video/android/core/notifications/DefaultStreamIntentResolver;
+	public fun getLeaveAction (Landroid/app/PendingIntent;)Landroidx/core/app/NotificationCompat$Action;
+	public fun getNotification (Lkotlin/jvm/functions/Function1;)Landroid/app/Notification;
 	public final fun getNotificationIconRes ()I
 	protected final fun getNotificationManager ()Landroidx/core/app/NotificationManagerCompat;
 	public fun getNotificationUpdates (Lkotlinx/coroutines/CoroutineScope;Lio/getstream/video/android/core/Call;Lio/getstream/video/android/model/User;Lkotlin/jvm/functions/Function1;)V
 	public fun getOngoingCallNotification (Lio/getstream/video/android/model/StreamCallId;Ljava/lang/String;ZI)Landroid/app/Notification;
+	public fun getRejectAction (Landroid/app/PendingIntent;)Landroidx/core/app/NotificationCompat$Action;
 	public fun getRingingCallNotification (Lio/getstream/video/android/core/RingingState;Lio/getstream/video/android/model/StreamCallId;Ljava/lang/String;Z)Landroid/app/Notification;
 	public fun getSettingUpCallNotification ()Landroid/app/Notification;
+	public fun isInForeground ()Z
+	public fun maybeCreateChannel (Ljava/lang/String;Landroid/content/Context;Lkotlin/jvm/functions/Function1;)V
+	public static synthetic fun maybeCreateChannel$default (Lio/getstream/video/android/core/notifications/DefaultNotificationHandler;Ljava/lang/String;Landroid/content/Context;Lkotlin/jvm/functions/Function1;ILjava/lang/Object;)V
 	public fun onLiveCall (Lio/getstream/video/android/model/StreamCallId;Ljava/lang/String;)V
 	public fun onMissedCall (Lio/getstream/video/android/model/StreamCallId;Ljava/lang/String;)V
 	public fun onNotification (Lio/getstream/video/android/model/StreamCallId;Ljava/lang/String;)V
@@ -4353,11 +4366,32 @@ public class io/getstream/video/android/core/notifications/DefaultNotificationHa
 	public fun onPermissionRationale ()V
 	public fun onPermissionRequested ()V
 	public fun onRingingCall (Lio/getstream/video/android/model/StreamCallId;Ljava/lang/String;)V
+	public fun showLiveCallNotification (Landroid/app/PendingIntent;Ljava/lang/String;I)V
+	public fun showMissedCallNotification (Landroid/app/PendingIntent;Ljava/lang/String;I)V
+	public fun showNotificationCallNotification (Landroid/app/PendingIntent;Ljava/lang/String;I)V
 }
 
 public final class io/getstream/video/android/core/notifications/DefaultNotificationHandler$Companion {
 }
 
+public final class io/getstream/video/android/core/notifications/DefaultStreamIntentResolver {
+	public fun <init> (Landroid/content/Context;)V
+	public final fun getContext ()Landroid/content/Context;
+	public final fun getDefaultPendingIntent ()Landroid/app/PendingIntent;
+	public final fun searchAcceptCallPendingIntent (Lio/getstream/video/android/model/StreamCallId;I)Landroid/app/PendingIntent;
+	public static synthetic fun searchAcceptCallPendingIntent$default (Lio/getstream/video/android/core/notifications/DefaultStreamIntentResolver;Lio/getstream/video/android/model/StreamCallId;IILjava/lang/Object;)Landroid/app/PendingIntent;
+	public final fun searchEndCallPendingIntent (Lio/getstream/video/android/model/StreamCallId;)Landroid/app/PendingIntent;
+	public final fun searchIncomingCallPendingIntent (Lio/getstream/video/android/model/StreamCallId;I)Landroid/app/PendingIntent;
+	public static synthetic fun searchIncomingCallPendingIntent$default (Lio/getstream/video/android/core/notifications/DefaultStreamIntentResolver;Lio/getstream/video/android/model/StreamCallId;IILjava/lang/Object;)Landroid/app/PendingIntent;
+	public final fun searchLiveCallPendingIntent (Lio/getstream/video/android/model/StreamCallId;I)Landroid/app/PendingIntent;
+	public final fun searchMissedCallPendingIntent (Lio/getstream/video/android/model/StreamCallId;I)Landroid/app/PendingIntent;
+	public final fun searchNotificationCallPendingIntent (Lio/getstream/video/android/model/StreamCallId;I)Landroid/app/PendingIntent;
+	public final fun searchOngoingCallPendingIntent (Lio/getstream/video/android/model/StreamCallId;I)Landroid/app/PendingIntent;
+	public final fun searchOutgoingCallPendingIntent (Lio/getstream/video/android/model/StreamCallId;I)Landroid/app/PendingIntent;
+	public static synthetic fun searchOutgoingCallPendingIntent$default (Lio/getstream/video/android/core/notifications/DefaultStreamIntentResolver;Lio/getstream/video/android/model/StreamCallId;IILjava/lang/Object;)Landroid/app/PendingIntent;
+	public final fun searchRejectCallPendingIntent (Lio/getstream/video/android/model/StreamCallId;)Landroid/app/PendingIntent;
+}
+
 public final class io/getstream/video/android/core/notifications/NotificationConfig {
 	public fun <init> ()V
 	public fun <init> (Ljava/util/List;Lkotlin/jvm/functions/Function0;Lio/getstream/video/android/core/notifications/NotificationHandler;ZLkotlin/jvm/functions/Function0;Z)V
@@ -4396,6 +4430,7 @@ public abstract interface class io/getstream/video/android/core/notifications/No
 	public static final field INTENT_EXTRA_CALL_CID Ljava/lang/String;
 	public static final field INTENT_EXTRA_CALL_DISPLAY_NAME Ljava/lang/String;
 	public static final field INTENT_EXTRA_NOTIFICATION_ID Ljava/lang/String;
+	public abstract fun getIncomingCallNotification (Landroid/app/PendingIntent;Landroid/app/PendingIntent;Landroid/app/PendingIntent;Ljava/lang/String;Z)Landroid/app/Notification;
 	public abstract fun getNotificationUpdates (Lkotlinx/coroutines/CoroutineScope;Lio/getstream/video/android/core/Call;Lio/getstream/video/android/model/User;Lkotlin/jvm/functions/Function1;)V
 	public abstract fun getOngoingCallNotification (Lio/getstream/video/android/model/StreamCallId;Ljava/lang/String;ZI)Landroid/app/Notification;
 	public static synthetic fun getOngoingCallNotification$default (Lio/getstream/video/android/core/notifications/NotificationHandler;Lio/getstream/video/android/model/StreamCallId;Ljava/lang/String;ZIILjava/lang/Object;)Landroid/app/Notification;

stream-video-android-core/src/main/kotlin/io/getstream/video/android/core/notifications/DefaultNotificationHandler.kt

@@ -42,7 +42,6 @@ import io.getstream.video.android.core.RingingState
 import io.getstream.video.android.core.notifications.NotificationHandler.Companion.ACTION_LIVE_CALL
 import io.getstream.video.android.core.notifications.NotificationHandler.Companion.ACTION_MISSED_CALL
 import io.getstream.video.android.core.notifications.NotificationHandler.Companion.ACTION_NOTIFICATION
-import io.getstream.video.android.core.notifications.internal.DefaultStreamIntentResolver
 import io.getstream.video.android.core.notifications.internal.service.CallService
 import io.getstream.video.android.model.StreamCallId
 import io.getstream.video.android.model.User
@@ -74,7 +73,7 @@ public open class DefaultNotificationHandler(
     NotificationPermissionHandler by notificationPermissionHandler {
 
     private val logger by taggedLogger("Call:NotificationHandler")
-    private val intentResolver = DefaultStreamIntentResolver(application)
+    val intentResolver = DefaultStreamIntentResolver(application)
     protected val notificationManager: NotificationManagerCompat by lazy {
         NotificationManagerCompat.from(application).also {
             if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
@@ -197,7 +196,7 @@ public open class DefaultNotificationHandler(
         }
     }
 
-    private fun getIncomingCallNotification(
+    override fun getIncomingCallNotification(
         fullScreenPendingIntent: PendingIntent,
         acceptCallPendingIntent: PendingIntent,
         rejectCallPendingIntent: PendingIntent,
@@ -209,7 +208,6 @@ public open class DefaultNotificationHandler(
         // screen instead - but this needs to be handled by the application.
         // The default behaviour is that all notification are high priority
         val showAsHighPriority = !hideRingingNotificationInForeground || !isInForeground()
-
         val channelId = application.getString(
             if (showAsHighPriority) {
                 R.string.stream_video_incoming_call_notification_channel_id
@@ -218,6 +216,35 @@ public open class DefaultNotificationHandler(
             },
         )
 
+        createIncomingCallChannel(channelId, showAsHighPriority)
+
+        return getNotification {
+            priority = NotificationCompat.PRIORITY_HIGH
+            setContentTitle(callerName)
+            setContentText(
+                application.getString(R.string.stream_video_incoming_call_notification_description),
+            )
+            setChannelId(channelId)
+            setOngoing(true)
+            setCategory(NotificationCompat.CATEGORY_CALL)
+            setFullScreenIntent(fullScreenPendingIntent, true)
+            if (shouldHaveContentIntent) {
+                setContentIntent(fullScreenPendingIntent)
+            } else {
+                val emptyIntent = PendingIntent.getActivity(
+                    application,
+                    0,
+                    Intent(),
+                    PendingIntent.FLAG_IMMUTABLE,
+                )
+                setContentIntent(emptyIntent)
+                setAutoCancel(false)
+            }
+            addCallActions(acceptCallPendingIntent, rejectCallPendingIntent, callerName)
+        }
+    }
+
+    open fun createIncomingCallChannel(channelId: String, showAsHighPriority: Boolean) {
         maybeCreateChannel(
             channelId = channelId,
             context = application,
@@ -246,31 +273,6 @@ public open class DefaultNotificationHandler(
                 }
             },
         )
-
-        return getNotification {
-            priority = NotificationCompat.PRIORITY_HIGH
-            setContentTitle(callerName)
-            setContentText(
-                application.getString(R.string.stream_video_incoming_call_notification_description),
-            )
-            setChannelId(channelId)
-            setOngoing(true)
-            setCategory(NotificationCompat.CATEGORY_CALL)
-            setFullScreenIntent(fullScreenPendingIntent, true)
-            if (shouldHaveContentIntent) {
-                setContentIntent(fullScreenPendingIntent)
-            } else {
-                val emptyIntent = PendingIntent.getActivity(
-                    application,
-                    0,
-                    Intent(),
-                    PendingIntent.FLAG_IMMUTABLE,
-                )
-                setContentIntent(emptyIntent)
-                setAutoCancel(false)
-            }
-            addCallActions(acceptCallPendingIntent, rejectCallPendingIntent, callerName)
-        }
     }
 
     override fun onNotification(callId: StreamCallId, callDisplayName: String) {
@@ -327,19 +329,8 @@ public open class DefaultNotificationHandler(
         val ongoingCallsChannelId = application.getString(
             R.string.stream_video_ongoing_call_notification_channel_id,
         )
-        maybeCreateChannel(
-            channelId = ongoingCallsChannelId,
-            context = application,
-            configure = {
-                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
-                    name = application.getString(
-                        R.string.stream_video_ongoing_call_notification_channel_title,
-                    )
-                    description =
-                        application.getString(R.string.stream_video_ongoing_call_notification_channel_description)
-                }
-            },
-        )
+
+        createOnGoingChannel(ongoingCallsChannelId)
 
         if (hangUpIntent == null) {
             logger.e { "End call intent is null, not showing notification!" }
@@ -379,6 +370,22 @@ public open class DefaultNotificationHandler(
             .build()
     }
 
+    open fun createOnGoingChannel(ongoingCallsChannelId: String) {
+        maybeCreateChannel(
+            channelId = ongoingCallsChannelId,
+            context = application,
+            configure = {
+                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+                    name = application.getString(
+                        R.string.stream_video_ongoing_call_notification_channel_title,
+                    )
+                    description =
+                        application.getString(R.string.stream_video_ongoing_call_notification_channel_description)
+                }
+            },
+        )
+    }
+
     override fun getNotificationUpdates(
         coroutineScope: CoroutineScope,
         call: Call,
@@ -460,7 +467,7 @@ public open class DefaultNotificationHandler(
         }
     }
 
-    private fun maybeCreateChannel(
+    open fun maybeCreateChannel(
         channelId: String,
         context: Context,
         configure: NotificationChannel.() -> Unit = {
@@ -481,7 +488,7 @@ public open class DefaultNotificationHandler(
         }
     }
 
-    private fun showNotificationCallNotification(
+    open fun showNotificationCallNotification(
         notificationPendingIntent: PendingIntent,
         callDisplayName: String,
         notificationId: Int,
@@ -493,7 +500,7 @@ public open class DefaultNotificationHandler(
         }
     }
 
-    private fun showMissedCallNotification(
+    open fun showMissedCallNotification(
         notificationPendingIntent: PendingIntent,
         callDisplayName: String,
         notificationId: Int,
@@ -504,7 +511,7 @@ public open class DefaultNotificationHandler(
         }
     }
 
-    private fun showLiveCallNotification(
+    open fun showLiveCallNotification(
         liveCallPendingIntent: PendingIntent,
         callDisplayName: String,
         notificationId: Int,
@@ -525,7 +532,7 @@ public open class DefaultNotificationHandler(
         notificationManager.notify(notificationId, notification)
     }
 
-    private fun getNotification(
+    open fun getNotification(
         builder: NotificationCompat.Builder.() -> Unit,
     ): Notification {
         return NotificationCompat.Builder(application, getChannelId())
@@ -535,7 +542,7 @@ public open class DefaultNotificationHandler(
             .build()
     }
 
-    private fun NotificationCompat.Builder.addHangUpAction(
+    open fun NotificationCompat.Builder.addHangUpAction(
         hangUpIntent: PendingIntent,
         callDisplayName: String,
         remoteParticipantCount: Int,
@@ -569,17 +576,11 @@ public open class DefaultNotificationHandler(
                 ),
             )
         } else {
-            addAction(
-                NotificationCompat.Action.Builder(
-                    null,
-                    application.getString(R.string.stream_video_call_notification_action_leave),
-                    hangUpIntent,
-                ).build(),
-            )
+            addAction(getLeaveAction(hangUpIntent))
         }
     }
 
-    private fun NotificationCompat.Builder.addCallActions(
+    open fun NotificationCompat.Builder.addCallActions(
         acceptCallPendingIntent: PendingIntent,
         rejectCallPendingIntent: PendingIntent,
         callDisplayName: String?,
@@ -605,24 +606,36 @@ public open class DefaultNotificationHandler(
                 ),
             )
         } else {
-            addAction(
-                NotificationCompat.Action.Builder(
-                    null,
-                    application.getString(R.string.stream_video_call_notification_action_accept),
-                    acceptCallPendingIntent,
-                ).build(),
-            )
-            addAction(
-                NotificationCompat.Action.Builder(
-                    null,
-                    application.getString(R.string.stream_video_call_notification_action_reject),
-                    rejectCallPendingIntent,
-                ).build(),
-            )
+            addAction(getAcceptAction(acceptCallPendingIntent))
+            addAction(getRejectAction(rejectCallPendingIntent))
         }
     }
 
-    private fun isInForeground(): Boolean {
+    open fun getLeaveAction(intent: PendingIntent): NotificationCompat.Action {
+        return NotificationCompat.Action.Builder(
+            null,
+            application.getString(R.string.stream_video_call_notification_action_leave),
+            intent,
+        ).build()
+    }
+
+    open fun getAcceptAction(intent: PendingIntent): NotificationCompat.Action {
+        return NotificationCompat.Action.Builder(
+            null,
+            application.getString(R.string.stream_video_call_notification_action_accept),
+            intent,
+        ).build()
+    }
+
+    open fun getRejectAction(intent: PendingIntent): NotificationCompat.Action {
+        return NotificationCompat.Action.Builder(
+            null,
+            application.getString(R.string.stream_video_call_notification_action_reject),
+            intent,
+        ).build()
+    }
+
+    open fun isInForeground(): Boolean {
         val appProcessInfo = ActivityManager.RunningAppProcessInfo()
         ActivityManager.getMyMemoryState(appProcessInfo)
         return (