expo-notifications 1.0.0-canary-20240927-ab8a962 → 1.0.0-canary-20241018-bf4b2f7

package/CHANGELOG.md

@@ -10,15 +10,27 @@
 ### 🎉 New features
 
 - Add clearLastNotificationResponseAsync to API. ([#31607](https://github.com/expo/expo/pull/31607) by [@douglowder](https://github.com/douglowder))
+- New monthly trigger type for scheduled notifications. ([#31823](https://github.com/expo/expo/pull/31823) by [@douglowder](https://github.com/douglowder))
 
 ### 🐛 Bug fixes
 
+- [ios] fix crash if expo-update reload happens while Notifications.requestPermissionsAsync() is showing native dialog ([#32096](https://github.com/expo/expo/pull/32096) by [@mfazekas](https://github.com/mfazekas))
+- [android] `createNotificationChannel` could return incorrect channel information ([#32000](https://github.com/expo/expo/pull/32000) by [@vonovak](https://github.com/vonovak))
+- [android] fix notifications with `ChannelAwareTrigger` not being presented ([#31999](https://github.com/expo/expo/pull/31999) by [@vonovak](https://github.com/vonovak))
+- export `PermissionStatus` as value, not as type ([#31968](https://github.com/expo/expo/pull/31968) by [@vonovak](https://github.com/vonovak))
+- throw improved error on invalid subscription in removeNotificationSubscription ([#31842](https://github.com/expo/expo/pull/31842) by [@vonovak](https://github.com/vonovak))
+- [android] fix notifications actions not being presented ([#31795](https://github.com/expo/expo/pull/31795) by [@vonovak](https://github.com/vonovak))
 - Add missing `react` and `react-native` peer dependencies for isolated modules. ([#30478](https://github.com/expo/expo/pull/30478) by [@byCedric](https://github.com/byCedric))
+- [iOS] do not overwrite existing aps entitlement. ([#31892](https://github.com/expo/expo/pull/31892) by [@douglowder](https://github.com/douglowder))
 
 ### 💡 Others
 
+- [android] refactor trigger serialization ([#32032](https://github.com/expo/expo/pull/32032) by [@vonovak](https://github.com/vonovak))
+- [android] simplify DateTrigger ([#32002](https://github.com/expo/expo/pull/32002) by [@vonovak](https://github.com/vonovak))
+- [android] refactor ExpoNotificationBuilder ([#31838](https://github.com/expo/expo/pull/31838) by [@vonovak](https://github.com/vonovak))
 - Warn about limited support in Expo Go ([#31573](https://github.com/expo/expo/pull/31573) by [@vonovak](https://github.com/vonovak))
 - Keep using the legacy event emitter as the module is not fully migrated to Expo Modules API. ([#28946](https://github.com/expo/expo/pull/28946) by [@tsapeta](https://github.com/tsapeta))
+- [Android] Convert trigger Java classes to Kotlin. ([#31856](https://github.com/expo/expo/pull/31856) by [@douglowder](https://github.com/douglowder))
 
 ## 0.28.17 - 2024-09-17
 
@@ -281,6 +293,7 @@ _This version does not introduce any user-facing changes._
 
 ### 🛠 Breaking changes
 
+- remove `usePermissions` hook ([#31905](https://github.com/expo/expo/pull/31905) by [@vonovak](https://github.com/vonovak))
 - [android] Set the "notification number" (sometimes used to increment badge count on some launchers) from the notification payload `badge` field. ([#17171](https://github.com/expo/expo/pull/17171) by [@danstepanov](https://github.com/danstepanov))
 
 ### 🐛 Bug fixes

package/android/build.gradle

@@ -1,4 +1,5 @@
 apply plugin: 'com.android.library'
+apply plugin: 'kotlin-parcelize'
 
 group = 'host.exp.exponent'
 version = '0.28.3'

package/android/src/main/java/expo/modules/notifications/notifications/NotificationManager.java

@@ -30,6 +30,10 @@ public class NotificationManager implements SingletonModule, expo.modules.notifi
   public NotificationManager() {
     mListenerReferenceMap = new WeakHashMap<>();
 
+    // TODO @vonovak there's a chain of listeners:
+    //  ExpoHandlingDelegate -> NotificationManager -> NotificationsEmitter
+    //                                              -> NotificationsHandler
+    // it seems it could be shorter?
     // Registers this singleton instance in static ExpoHandlingDelegate listeners collection.
     // Since it doesn't hold strong reference to the object this should be safe.
     ExpoHandlingDelegate.Companion.addListener(this);
@@ -81,6 +85,10 @@ public class NotificationManager implements SingletonModule, expo.modules.notifi
    * Calls {@link NotificationListener#onNotificationReceived(Notification)} on all values
    * of {@link NotificationManager#mListenerReferenceMap}.
    *
+   * In practice, that means calling {@link NotificationsEmitter} (just emits an event to JS) and
+   * {@link NotificationsHandler} which calls `handleNotification` in JS to determine the behavior.
+   * Then `SingleNotificationHandlerTask.processNotificationWithBehavior` may present it.
+   *
    * @param notification Notification received
    */
   public void onNotificationReceived(Notification notification) {

package/android/src/main/java/expo/modules/notifications/notifications/NotificationSerializer.java

@@ -32,6 +32,7 @@ import expo.modules.notifications.notifications.model.triggers.FirebaseNotificat
 
 import expo.modules.notifications.notifications.triggers.DailyTrigger;
 import expo.modules.notifications.notifications.triggers.DateTrigger;
+import expo.modules.notifications.notifications.triggers.MonthlyTrigger;
 import expo.modules.notifications.notifications.triggers.TimeIntervalTrigger;
 import expo.modules.notifications.notifications.triggers.WeeklyTrigger;
 import expo.modules.notifications.notifications.triggers.YearlyTrigger;
@@ -57,11 +58,12 @@ public class NotificationSerializer {
   public static Bundle toBundle(NotificationRequest request) {
     Bundle serializedRequest = new Bundle();
     serializedRequest.putString("identifier", request.getIdentifier());
-    serializedRequest.putBundle("trigger", toBundle(request.getTrigger()));
+    NotificationTrigger requestTrigger = request.getTrigger();
+    serializedRequest.putBundle("trigger", requestTrigger == null ? null : requestTrigger.toBundle());
     Bundle content = toBundle(request.getContent());
     Bundle existingContentData = content.getBundle("data");
     if (existingContentData == null) {
-      if(request.getTrigger() instanceof FirebaseNotificationTrigger trigger) {
+      if(requestTrigger instanceof FirebaseNotificationTrigger trigger) {
         RemoteMessage message = trigger.getRemoteMessage();
         RemoteMessage.Notification notification = message.getNotification();
         Map<String, String> data = message.getData();
@@ -76,8 +78,8 @@ public class NotificationSerializer {
           content.putBundle("data", toBundle(data));
         }
       } else if(
-        request.getTrigger() instanceof SchedulableNotificationTrigger ||
-          request.getTrigger() == null
+        requestTrigger instanceof SchedulableNotificationTrigger ||
+          requestTrigger == null
       ) {
         JSONObject body = request.getContent().getBody();
         if (body != null) {
@@ -101,7 +103,7 @@ public class NotificationSerializer {
   public static Bundle toBundle(INotificationContent content) {
     Bundle serializedContent = new Bundle();
     serializedContent.putString("title", content.getTitle());
-    serializedContent.putString("subtitle", content.getSubtitle());
+    serializedContent.putString("subtitle", content.getSubText());
     serializedContent.putString("body", content.getText());
     if (content.getColor() != null) {
       serializedContent.putString("color", String.format("#%08X", content.getColor().intValue()));
@@ -186,50 +188,6 @@ public class NotificationSerializer {
     return result;
   }
 
-  private static Bundle toBundle(@Nullable NotificationTrigger trigger) {
-    if (trigger == null) {
-      return null;
-    }
-    Bundle bundle = new Bundle();
-    if (trigger instanceof FirebaseNotificationTrigger) {
-      bundle.putString("type", "push");
-      bundle.putBundle("remoteMessage", RemoteMessageSerializer.toBundle(((FirebaseNotificationTrigger) trigger).getRemoteMessage()));
-    } else if (trigger instanceof TimeIntervalTrigger) {
-      bundle.putString("type", "timeInterval");
-      bundle.putBoolean("repeats", ((TimeIntervalTrigger) trigger).isRepeating());
-      bundle.putLong("seconds", ((TimeIntervalTrigger) trigger).getTimeInterval());
-    } else if (trigger instanceof DateTrigger) {
-      bundle.putString("type", "date");
-      bundle.putBoolean("repeats", false);
-      bundle.putLong("value", ((DateTrigger) trigger).getTriggerDate().getTime());
-    } else if (trigger instanceof DailyTrigger) {
-      bundle.putString("type", "daily");
-      bundle.putInt("hour", ((DailyTrigger) trigger).getHour());
-      bundle.putInt("minute", ((DailyTrigger) trigger).getMinute());
-    } else if (trigger instanceof WeeklyTrigger) {
-      bundle.putString("type", "weekly");
-      bundle.putInt("weekday", ((WeeklyTrigger) trigger).getWeekday());
-      bundle.putInt("hour", ((WeeklyTrigger) trigger).getHour());
-      bundle.putInt("minute", ((WeeklyTrigger) trigger).getMinute());
-    } else if (trigger instanceof YearlyTrigger) {
-      bundle.putString("type", "yearly");
-      bundle.putInt("day", ((YearlyTrigger) trigger).getDay());
-      bundle.putInt("month", ((YearlyTrigger) trigger).getMonth());
-      bundle.putInt("hour", ((YearlyTrigger) trigger).getHour());
-      bundle.putInt("minute", ((YearlyTrigger) trigger).getMinute());
-    } else {
-      bundle.putString("type", "unknown");
-    }
-    bundle.putString("channelId", getChannelId(trigger));
-
-    return bundle;
-  }
-
-  @Nullable
-  private static String getChannelId(NotificationTrigger trigger) {
-    return trigger.getNotificationChannel();
-  }
-
   @NotNull
   public static Bundle toResponseBundleFromExtras(Bundle extras) {
     Bundle serializedContent = new Bundle();

package/android/src/main/java/expo/modules/notifications/notifications/background/BackgroundRemoteNotificationTaskConsumer.java

@@ -25,9 +25,10 @@ import expo.modules.interfaces.taskManager.TaskManagerUtilsInterface;
 /**
  * Represents a task to be run when the app is receives a remote push
  * notification. Map of current tasks is maintained in {@link FirebaseMessagingDelegate}.
+ *
+ * Instances are instantiated by expo task manager, after being registered in ExpoBackgroundNotificationTasksModule
  */
 public class BackgroundRemoteNotificationTaskConsumer extends TaskConsumer implements TaskConsumerInterface {
-  private static final String TAG = BackgroundRemoteNotificationTaskConsumer.class.getSimpleName();
   private static final String NOTIFICATION_KEY = "notification";
 
   private TaskInterface mTask;

package/android/src/main/java/expo/modules/notifications/notifications/channels/managers/AndroidXNotificationsChannelManager.java

@@ -80,7 +80,10 @@ public class AndroidXNotificationsChannelManager implements NotificationsChannel
     NotificationChannel channel = new NotificationChannel(channelId, name, importance);
     configureChannelWithOptions(channel, channelOptions);
     mNotificationManager.createNotificationChannel(channel);
-    return channel;
+    // We return the channel given by mNotificationManager, not the one we created.
+    // see "Note that the created channel may differ from this value." ("this value" = the one we provided)
+    // https://developer.android.com/reference/android/app/NotificationManager#createNotificationChannel(android.app.NotificationChannel)
+    return mNotificationManager.getNotificationChannel(channelId);
   }
 
   // Processing options

package/android/src/main/java/expo/modules/notifications/notifications/debug/DebugLogging.kt

@@ -70,10 +70,10 @@ object DebugLogging {
       """
       $caller:
         notification.notificationRequest.content.title: ${notification.notificationRequest.content.title}
-        notification.notificationRequest.content.subtitle: ${notification.notificationRequest.content.subtitle}
+        notification.notificationRequest.content.subText: ${notification.notificationRequest.content.subText}
         notification.notificationRequest.content.text: ${notification.notificationRequest.content.text}
         notification.notificationRequest.content.sound: ${notification.notificationRequest.content.soundName}
-        notification.notificationRequest.content.channelID: ${notification.notificationRequest.trigger.notificationChannel}
+        notification.notificationRequest.content.channelID: ${notification.notificationRequest.trigger.getNotificationChannel()}
         notification.notificationRequest.content.body: ${notification.notificationRequest.content.body}
         notification.notificationRequest.content.color: ${notification.notificationRequest.content.color}
         notification.notificationRequest.content.vibrationPattern: ${notification.notificationRequest.content.vibrationPattern?.contentToString()}

package/android/src/main/java/expo/modules/notifications/notifications/handling/NotificationsHandler.kt

@@ -99,7 +99,7 @@ open class NotificationsHandler : Module(), NotificationListener {
       ?: throw NotificationWasAlreadyHandledException(identifier)
 
     with(behavior) {
-      task.handleResponse(
+      task.processNotificationWithBehavior(
         NotificationBehavior(shouldShowAlert, shouldPlaySound, shouldSetBadge, priority),
         promise
       )
@@ -110,6 +110,8 @@ open class NotificationsHandler : Module(), NotificationListener {
    * Callback called by [NotificationManager] to inform its listeners of new messages.
    * Starts up a new [SingleNotificationHandlerTask] which will take it on from here.
    *
+   * SingleNotificationHandlerTask.processNotificationWithBehavior can then present it
+   *
    * @param notification Notification received
    */
   override fun onNotificationReceived(notification: Notification) {

package/android/src/main/java/expo/modules/notifications/notifications/handling/SingleNotificationHandlerTask.java

@@ -34,7 +34,6 @@ public class SingleNotificationHandlerTask {
   private Handler mHandler;
   private EventEmitter mEventEmitter;
   private Notification mNotification;
-  private NotificationBehavior mBehavior;
   private Context mContext;
   private NotificationsHandler mDelegate;
 
@@ -88,12 +87,11 @@ public class SingleNotificationHandlerTask {
    * @param behavior Behavior requested by the app
    * @param promise  Promise to fulfill once the behavior is applied to the notification.
    */
-  /* package */ void handleResponse(NotificationBehavior behavior, final Promise promise) {
-    mBehavior = behavior;
+  /* package */ void processNotificationWithBehavior(final NotificationBehavior behavior, final Promise promise) {
     mHandler.post(new Runnable() {
       @Override
       public void run() {
-        NotificationsService.Companion.present(mContext, mNotification, mBehavior, new ResultReceiver(mHandler) {
+        NotificationsService.Companion.present(mContext, mNotification, behavior, new ResultReceiver(mHandler) {
           @Override
           protected void onReceiveResult(int resultCode, Bundle resultData) {
             super.onReceiveResult(resultCode, resultData);

package/android/src/main/java/expo/modules/notifications/notifications/interfaces/INotificationContent.kt

@@ -17,7 +17,7 @@ import org.json.JSONObject
 interface INotificationContent : Parcelable {
   val title: String?
   val text: String?
-  val subtitle: String?
+  val subText: String?
   val badgeCount: Number?
   val shouldPlayDefaultSound: Boolean
 
@@ -27,7 +27,7 @@ interface INotificationContent : Parcelable {
   val shouldUseDefaultVibrationPattern: Boolean
   val vibrationPattern: LongArray?
   val body: JSONObject?
-  val priority: NotificationPriority
+  val priority: NotificationPriority?
   val color: Number?
   val isAutoDismiss: Boolean
   val categoryId: String?

package/android/src/main/java/expo/modules/notifications/notifications/interfaces/NotificationBuilder.kt

@@ -8,14 +8,6 @@ import expo.modules.notifications.notifications.model.NotificationBehavior
  * on a [NotificationContent] spec.
  */
 interface NotificationBuilder {
-  /**
-   * Pass in a [Notification] based on which the Android notification should be based.
-   *
-   * @param notification [Notification] on which the notification should be based.
-   * @return The same instance of [NotificationBuilder] updated with the notification.
-   */
-  fun setNotification(notification: Notification?): NotificationBuilder?
-
   /**
    * Pass in a [NotificationBehavior] if you want to override the behavior
    * of the notification, i.e. whether it should show a heads-up alert, set badge, etc.
@@ -23,7 +15,7 @@ interface NotificationBuilder {
    * @param behavior [NotificationBehavior] to which the presentation effect should conform.
    * @return The same instance of [NotificationBuilder] updated with the remote message.
    */
-  fun setAllowedBehavior(behavior: NotificationBehavior?): NotificationBuilder?
+  fun setAllowedBehavior(behavior: NotificationBehavior?): NotificationBuilder
 
   /**
    * Builds the Android notification based on passed in data.

package/android/src/main/java/expo/modules/notifications/notifications/interfaces/NotificationListener.java

@@ -13,7 +13,7 @@ import expo.modules.notifications.notifications.model.NotificationResponse;
  */
 public interface NotificationListener {
   /**
-   * Callback called when new notification is received.
+   * Callback called when new notification is received while the app is in foreground.
    *
    * @param notification Notification received
    */

package/android/src/main/java/expo/modules/notifications/notifications/interfaces/NotificationTrigger.kt

@@ -0,0 +1,19 @@
+package expo.modules.notifications.notifications.interfaces
+
+import android.os.Bundle
+import android.os.Parcelable
+
+/**
+ * An interface specifying source of the notification, to be implemented
+ * by concrete classes.
+ */
+interface NotificationTrigger : Parcelable {
+  // these are functions so that we're absolutely sure @Parcelize doesn't try to parcelize them
+  // (as opposed to if they were properties)
+
+  fun getNotificationChannel(): String? {
+    return null
+  }
+
+  fun toBundle(): Bundle
+}

package/android/src/main/java/expo/modules/notifications/notifications/model/NotificationAction.java

@@ -7,6 +7,9 @@ import java.io.Serializable;
 
 /**
  * A class representing a single notification action button.
+ *
+ * TODO vonovak: no need to implement serializable, parcelable is enough for storing
+ *
  */
 public class NotificationAction implements Parcelable, Serializable {
   private final String mIdentifier;

package/android/src/main/java/expo/modules/notifications/notifications/model/NotificationCategory.java

@@ -9,6 +9,8 @@ import java.util.List;
 
 /**
  * A class representing a collection of notification actions.
+ *
+ * TODO vonovak: no need to implement serializable, parcelable is enough for storing
  */
 public class NotificationCategory implements Parcelable, Serializable {
   private final String mIdentifier;

package/android/src/main/java/expo/modules/notifications/notifications/model/NotificationContent.java

@@ -75,7 +75,7 @@ public class NotificationContent implements Parcelable, Serializable, INotificat
   }
 
   @Nullable
-  public String getSubtitle() {
+  public String getSubText() {
     return mSubtitle;
   }
 

package/android/src/main/java/expo/modules/notifications/notifications/model/RemoteNotificationContent.kt

@@ -75,7 +75,7 @@ class RemoteNotificationContent(private val remoteMessage: RemoteMessage) : INot
   override val isSticky: Boolean
     get() = remoteMessage.data["sticky"]?.toBoolean() ?: false
 
-  override val subtitle: String?
+  override val subText: String?
     get() = remoteMessage.data["subtitle"]
 
   override val badgeCount: Number?

package/android/src/main/java/expo/modules/notifications/notifications/model/triggers/FirebaseNotificationTrigger.kt

@@ -1,30 +1,38 @@
 package expo.modules.notifications.notifications.model.triggers
 
 import android.os.Build
+import android.os.Bundle
 import android.os.Parcel
 import android.os.Parcelable
 import androidx.annotation.RequiresApi
+import androidx.core.os.bundleOf
 import com.google.firebase.messaging.RemoteMessage
+import expo.modules.notifications.notifications.RemoteMessageSerializer
 import expo.modules.notifications.notifications.interfaces.NotificationTrigger
 
 /**
  * A trigger representing an incoming remote Firebase notification.
  */
-class FirebaseNotificationTrigger(private val remoteMessage: RemoteMessage) : NotificationTrigger {
+class FirebaseNotificationTrigger(val remoteMessage: RemoteMessage) : NotificationTrigger {
 
   private constructor(parcel: Parcel) : this(
     parcel.readParcelable(FirebaseNotificationTrigger::class.java.classLoader)
       ?: throw IllegalArgumentException("RemoteMessage from readParcelable must not be null")
   )
 
-  fun getRemoteMessage(): RemoteMessage = remoteMessage
-
   @RequiresApi(api = Build.VERSION_CODES.O)
   override fun getNotificationChannel(): String? {
     val channelId = remoteMessage.notification?.channelId ?: remoteMessage.data["channelId"]
     return channelId ?: super.getNotificationChannel()
   }
 
+  override fun toBundle(): Bundle {
+    return bundleOf(
+      "type" to "push",
+      "remoteMessage" to RemoteMessageSerializer.toBundle(remoteMessage)
+    )
+  }
+
   override fun describeContents(): Int {
     return 0
   }

package/android/src/main/java/expo/modules/notifications/notifications/presentation/ExpoNotificationPresentationModule.kt

@@ -11,6 +11,8 @@ import expo.modules.notifications.ResultReceiverBody
 import expo.modules.notifications.createDefaultResultReceiver
 import expo.modules.notifications.notifications.ArgumentsNotificationContentBuilder
 import expo.modules.notifications.notifications.NotificationSerializer
+import expo.modules.notifications.notifications.interfaces.INotificationContent
+import expo.modules.notifications.notifications.interfaces.NotificationTrigger
 import expo.modules.notifications.notifications.model.Notification
 import expo.modules.notifications.notifications.model.NotificationRequest
 import expo.modules.notifications.service.NotificationsService
@@ -31,7 +33,7 @@ open class ExpoNotificationPresentationModule : Module() {
 
     AsyncFunction("presentNotificationAsync") { identifier: String, payload: ReadableArguments, promise: Promise ->
       val content = ArgumentsNotificationContentBuilder(context).setPayload(payload).build()
-      val request = NotificationRequest(identifier, content, null)
+      val request = createNotificationRequest(identifier, content, null)
       val notification = Notification(request)
       present(
         context,
@@ -54,7 +56,7 @@ open class ExpoNotificationPresentationModule : Module() {
         createResultReceiver { resultCode: Int, resultData: Bundle? ->
           val notifications = resultData?.getParcelableArrayList<Notification>(NotificationsService.NOTIFICATIONS_KEY)
           if (resultCode == NotificationsService.SUCCESS_CODE && notifications != null) {
-            promise.resolve(notifications.map(NotificationSerializer::toBundle))
+            promise.resolve(serializeNotifications(notifications))
           } else {
             val e = resultData?.getSerializable(NotificationsService.EXCEPTION_KEY) as? Exception
             promise.reject("ERR_NOTIFICATIONS_FETCH_FAILED", "A list of displayed notifications could not be fetched.", e)
@@ -96,4 +98,16 @@ open class ExpoNotificationPresentationModule : Module() {
       }
     )
   }
+
+  protected open fun createNotificationRequest(
+    identifier: String,
+    content: INotificationContent,
+    trigger: NotificationTrigger?
+  ): NotificationRequest {
+    return NotificationRequest(identifier, content, null)
+  }
+
+  protected open fun serializeNotifications(notifications: Collection<Notification>): List<Bundle> {
+    return notifications.map(NotificationSerializer::toBundle)
+  }
 }

package/android/src/main/java/expo/modules/notifications/notifications/presentation/builders/BaseNotificationBuilder.kt

@@ -0,0 +1,148 @@
+package expo.modules.notifications.notifications.presentation.builders
+
+import android.app.NotificationChannel
+import android.app.NotificationManager
+import android.content.Context
+import android.os.Build
+import android.util.Log
+import androidx.annotation.RequiresApi
+import androidx.core.app.NotificationCompat
+import expo.modules.notifications.R
+import expo.modules.notifications.notifications.channels.managers.AndroidXNotificationsChannelGroupManager
+import expo.modules.notifications.notifications.channels.managers.AndroidXNotificationsChannelManager
+import expo.modules.notifications.notifications.channels.managers.NotificationsChannelManager
+import expo.modules.notifications.notifications.interfaces.INotificationContent
+import expo.modules.notifications.notifications.interfaces.NotificationBuilder
+import expo.modules.notifications.notifications.model.Notification
+import expo.modules.notifications.notifications.model.NotificationBehavior
+
+/**
+ * A foundation class for [NotificationBuilder] implementations. Takes care
+ * of accepting [.mNotification] and [.mNotificationBehavior].
+ */
+abstract class BaseNotificationBuilder protected constructor(protected val context: Context, protected val notification: Notification) :
+  NotificationBuilder {
+
+  protected var notificationBehavior: NotificationBehavior? = null
+    private set
+
+  override fun setAllowedBehavior(behavior: NotificationBehavior?): NotificationBuilder {
+    notificationBehavior = behavior
+    return this
+  }
+
+  fun createBuilder(): NotificationCompat.Builder {
+    val builder = channelId?.let { NotificationCompat.Builder(context, it) } ?: NotificationCompat.Builder(context)
+    return builder
+  }
+
+  protected val channelId: String?
+    /**
+     * @return A [NotificationChannel]'s identifier to use for the notification.
+     */
+    get() {
+      if (Build.VERSION.SDK_INT < Build.VERSION_CODES.O) {
+        // Returning null on incompatible platforms won't be an error.
+        return null
+      }
+
+      val trigger = notification.notificationRequest?.trigger
+      if (trigger == null) {
+        Log.e(
+          "notifications",
+          String.format(
+            "Couldn't get channel for the notifications - trigger is 'null'. Fallback to '%s' channel",
+            FALLBACK_CHANNEL_ID
+          )
+        )
+        return fallbackNotificationChannel!!.id
+      }
+
+      val requestedChannelId = trigger.getNotificationChannel()
+        ?: return fallbackNotificationChannel!!.id
+
+      val channelForRequestedId =
+        notificationsChannelManager.getNotificationChannel(requestedChannelId)
+      if (channelForRequestedId == null) {
+        Log.e(
+          "notifications",
+          String.format(
+            "Channel '%s' doesn't exists. Fallback to '%s' channel",
+            requestedChannelId,
+            FALLBACK_CHANNEL_ID
+          )
+        )
+        return fallbackNotificationChannel!!.id
+      }
+
+      return channelForRequestedId.id
+    }
+
+  open val notificationsChannelManager: NotificationsChannelManager
+    get() = AndroidXNotificationsChannelManager(
+      context,
+      AndroidXNotificationsChannelGroupManager(context)
+    )
+
+  private val fallbackNotificationChannel: NotificationChannel?
+    /**
+     * Fetches the fallback notification channel, and if it doesn't exist yet - creates it.
+     *
+     *
+     * Returns null on [NotificationChannel]-incompatible platforms.
+     *
+     * @return Fallback [NotificationChannel] or null.
+     */
+    get() {
+      if (Build.VERSION.SDK_INT < Build.VERSION_CODES.O) {
+        return null
+      }
+
+      val channel = notificationManager.getNotificationChannel(FALLBACK_CHANNEL_ID)
+      return channel ?: createFallbackChannel()
+    }
+
+  /**
+   * Creates a fallback channel of [.FALLBACK_CHANNEL_ID] ID, name fetched
+   * from Android resources ([.getFallbackChannelName]
+   * and importance set by [.FALLBACK_CHANNEL_IMPORTANCE].
+   *
+   * @return Newly created channel.
+   */
+  @RequiresApi(api = Build.VERSION_CODES.O)
+  protected fun createFallbackChannel(): NotificationChannel {
+    val channel = NotificationChannel(
+      FALLBACK_CHANNEL_ID,
+      fallbackChannelName,
+      FALLBACK_CHANNEL_IMPORTANCE
+    )
+    channel.setShowBadge(true)
+    channel.enableVibration(true)
+    notificationManager.createNotificationChannel(channel)
+    return channel
+  }
+
+  private val fallbackChannelName: String
+    /**
+     * Fetches fallback channel name from Android resources. Overridable by Android resources system
+     *
+     * @return Name of the fallback channel
+     */
+    get() = context.getString(R.string.expo_notifications_fallback_channel_name)
+
+  private val notificationManager: NotificationManager
+    get() = context.getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
+
+  companion object {
+    private const val FALLBACK_CHANNEL_ID = "expo_notifications_fallback_notification_channel"
+
+    // Behaviors we will want to impose on received notifications include
+    // being displayed as a heads-up notification. For that we will need
+    // a channel of high importance.
+    @RequiresApi(api = Build.VERSION_CODES.N)
+    private val FALLBACK_CHANNEL_IMPORTANCE = NotificationManager.IMPORTANCE_HIGH
+  }
+
+  protected val notificationContent: INotificationContent
+    get() = notification.notificationRequest.content
+}