react-native-notify-kit 9.3.0 → 9.4.0

package/android/src/main/java/app/notifee/core/NotificationManager.java

@@ -31,6 +31,7 @@ import android.graphics.Bitmap;
 import android.net.Uri;
 import android.os.Build;
 import android.os.Bundle;
+import android.os.Trace;
 import android.service.notification.StatusBarNotification;
 import androidx.annotation.NonNull;
 import androidx.concurrent.futures.CallbackToFutureAdapter;
@@ -103,198 +104,204 @@ class NotificationManager {
      */
     Callable<NotificationCompat.Builder> builderCallable =
         () -> {
-          Boolean hasCustomSound = false;
-          NotificationCompat.Builder builder =
-              new NotificationCompat.Builder(getApplicationContext(), androidModel.getChannelId());
-
-          // must always keep at top
-          builder.setExtras(notificationModel.getData());
-
-          builder.setDeleteIntent(
-              ReceiverService.createIntent(
-                  ReceiverService.DELETE_INTENT,
-                  new String[] {"notification"},
-                  notificationModel.toBundle()));
-          // Resolve the effective pressAction bundle for the content intent.
-          // Three cases:
-          //   1. pressAction is null (absent from bundle, e.g. trigger rehydrated from Room DB
-          //      after app kill): synthesize default { id:'default', launchActivity:'default' }
-          //      so tapping the notification opens the app (defense-in-depth for paths that
-          //      bypass the TS validator).
-          //   2. pressAction has the opt-out sentinel id: user explicitly passed
-          //      pressAction: null in JS — pass null to createIntent so no launch intent
-          //      is created (non-tappable notification).
-          //   3. pressAction is a normal bundle: pass through unchanged.
-          // Resolve the effective pressAction bundle for the content intent.
-          // Three cases:
-          //   1. pressAction is null (absent from bundle, e.g. trigger rehydrated from Room DB
-          //      after app kill): synthesize default { id:'default', launchActivity:'default' }
-          //      so tapping the notification opens the app (defense-in-depth for paths that
-          //      bypass the TS validator).
-          //   2. pressAction has the opt-out sentinel id: user explicitly passed
-          //      pressAction: null in JS — pass null to createIntent so no launch intent
-          //      is created (non-tappable notification).
-          //   3. pressAction is a normal bundle: pass through unchanged.
-          //
-          // pressActionForIntent  → used for creating the launch intent (or null for opt-out)
-          // pressActionForExtras  → used in the receiver intent extras (event payload);
-          //                         null for cases 1 & 2 to avoid leaking synthesized defaults
-          //                         or the sentinel id into the JS event.
-          Bundle pressActionForIntent = androidModel.getPressAction();
-          Bundle pressActionForExtras = pressActionForIntent;
-          if (pressActionForIntent == null) {
-            // Case 1: absent — synthesize default for launch, null for extras
-            pressActionForIntent = new Bundle();
-            pressActionForIntent.putString("id", "default");
-            pressActionForIntent.putString("launchActivity", "default");
-            // pressActionForExtras stays null: the original notification didn't have
-            // pressAction, so the event shouldn't either.
-          } else if (NotificationPendingIntent.PRESS_ACTION_OPT_OUT_ID.equals(
-              pressActionForIntent.getString("id"))) {
-            // Case 2: explicit opt-out sentinel — no launch intent, no sentinel in extras
-            pressActionForIntent = null;
-            pressActionForExtras = null;
-          }
-          // Case 3: normal pressAction — both variables point to the original bundle
-
-          int targetSdkVersion =
-              ContextHolder.getApplicationContext().getApplicationInfo().targetSdkVersion;
-          if (targetSdkVersion >= Build.VERSION_CODES.S
-              && Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
-            builder.setContentIntent(
-                NotificationPendingIntent.createIntent(
-                    notificationModel.getHashCode(),
-                    pressActionForIntent,
-                    TYPE_PRESS,
-                    new String[] {"notification", "pressAction"},
-                    notificationModel.toBundle(),
-                    pressActionForExtras));
-          } else {
-            builder.setContentIntent(
+          Trace.beginSection("notifee:buildNotification");
+          try {
+            Boolean hasCustomSound = false;
+            NotificationCompat.Builder builder =
+                new NotificationCompat.Builder(
+                    getApplicationContext(), androidModel.getChannelId());
+
+            // must always keep at top
+            builder.setExtras(notificationModel.getData());
+
+            builder.setDeleteIntent(
                 ReceiverService.createIntent(
-                    ReceiverService.PRESS_INTENT,
-                    new String[] {"notification", "pressAction"},
-                    notificationModel.toBundle(),
-                    pressActionForIntent));
-          }
+                    ReceiverService.DELETE_INTENT,
+                    new String[] {"notification"},
+                    notificationModel.toBundle()));
+            // Resolve the effective pressAction bundle for the content intent.
+            // Three cases:
+            //   1. pressAction is null (absent from bundle, e.g. trigger rehydrated from Room DB
+            //      after app kill): synthesize default { id:'default', launchActivity:'default' }
+            //      so tapping the notification opens the app (defense-in-depth for paths that
+            //      bypass the TS validator).
+            //   2. pressAction has the opt-out sentinel id: user explicitly passed
+            //      pressAction: null in JS — pass null to createIntent so no launch intent
+            //      is created (non-tappable notification).
+            //   3. pressAction is a normal bundle: pass through unchanged.
+            // Resolve the effective pressAction bundle for the content intent.
+            // Three cases:
+            //   1. pressAction is null (absent from bundle, e.g. trigger rehydrated from Room DB
+            //      after app kill): synthesize default { id:'default', launchActivity:'default' }
+            //      so tapping the notification opens the app (defense-in-depth for paths that
+            //      bypass the TS validator).
+            //   2. pressAction has the opt-out sentinel id: user explicitly passed
+            //      pressAction: null in JS — pass null to createIntent so no launch intent
+            //      is created (non-tappable notification).
+            //   3. pressAction is a normal bundle: pass through unchanged.
+            //
+            // pressActionForIntent  → used for creating the launch intent (or null for opt-out)
+            // pressActionForExtras  → used in the receiver intent extras (event payload);
+            //                         null for cases 1 & 2 to avoid leaking synthesized defaults
+            //                         or the sentinel id into the JS event.
+            Bundle pressActionForIntent = androidModel.getPressAction();
+            Bundle pressActionForExtras = pressActionForIntent;
+            if (pressActionForIntent == null) {
+              // Case 1: absent — synthesize default for launch, null for extras
+              pressActionForIntent = new Bundle();
+              pressActionForIntent.putString("id", "default");
+              pressActionForIntent.putString("launchActivity", "default");
+              // pressActionForExtras stays null: the original notification didn't have
+              // pressAction, so the event shouldn't either.
+            } else if (NotificationPendingIntent.PRESS_ACTION_OPT_OUT_ID.equals(
+                pressActionForIntent.getString("id"))) {
+              // Case 2: explicit opt-out sentinel — no launch intent, no sentinel in extras
+              pressActionForIntent = null;
+              pressActionForExtras = null;
+            }
+            // Case 3: normal pressAction — both variables point to the original bundle
+
+            int targetSdkVersion =
+                ContextHolder.getApplicationContext().getApplicationInfo().targetSdkVersion;
+            if (targetSdkVersion >= Build.VERSION_CODES.S
+                && Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
+              builder.setContentIntent(
+                  NotificationPendingIntent.createIntent(
+                      notificationModel.getHashCode(),
+                      pressActionForIntent,
+                      TYPE_PRESS,
+                      new String[] {"notification", "pressAction"},
+                      notificationModel.toBundle(),
+                      pressActionForExtras));
+            } else {
+              builder.setContentIntent(
+                  ReceiverService.createIntent(
+                      ReceiverService.PRESS_INTENT,
+                      new String[] {"notification", "pressAction"},
+                      notificationModel.toBundle(),
+                      pressActionForIntent));
+            }
 
-          if (notificationModel.getTitle() != null) {
-            builder.setContentTitle(TextUtils.fromHtml(notificationModel.getTitle()));
-          }
+            if (notificationModel.getTitle() != null) {
+              builder.setContentTitle(TextUtils.fromHtml(notificationModel.getTitle()));
+            }
 
-          if (notificationModel.getSubTitle() != null) {
-            builder.setSubText(TextUtils.fromHtml(notificationModel.getSubTitle()));
-          }
+            if (notificationModel.getSubTitle() != null) {
+              builder.setSubText(TextUtils.fromHtml(notificationModel.getSubTitle()));
+            }
 
-          if (notificationModel.getBody() != null) {
-            builder.setContentText(TextUtils.fromHtml(notificationModel.getBody()));
-          }
+            if (notificationModel.getBody() != null) {
+              builder.setContentText(TextUtils.fromHtml(notificationModel.getBody()));
+            }
 
-          if (androidModel.getBadgeIconType() != null) {
-            builder.setBadgeIconType(androidModel.getBadgeIconType());
-          }
+            if (androidModel.getBadgeIconType() != null) {
+              builder.setBadgeIconType(androidModel.getBadgeIconType());
+            }
 
-          if (androidModel.getCategory() != null) {
-            builder.setCategory(androidModel.getCategory());
-          }
+            if (androidModel.getCategory() != null) {
+              builder.setCategory(androidModel.getCategory());
+            }
 
-          if (androidModel.getColor() != null) {
-            builder.setColor(androidModel.getColor());
-          }
+            if (androidModel.getColor() != null) {
+              builder.setColor(androidModel.getColor());
+            }
 
-          builder.setColorized(androidModel.getColorized());
+            builder.setColorized(androidModel.getColorized());
 
-          if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
-            builder.setChronometerCountDown(androidModel.getChronometerCountDown());
-          }
+            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
+              builder.setChronometerCountDown(androidModel.getChronometerCountDown());
+            }
 
-          if (androidModel.getGroup() != null) {
-            builder.setGroup(androidModel.getGroup());
-          }
+            if (androidModel.getGroup() != null) {
+              builder.setGroup(androidModel.getGroup());
+            }
 
-          builder.setGroupAlertBehavior(androidModel.getGroupAlertBehaviour());
-          builder.setGroupSummary(androidModel.getGroupSummary());
+            builder.setGroupAlertBehavior(androidModel.getGroupAlertBehaviour());
+            builder.setGroupSummary(androidModel.getGroupSummary());
 
-          if (androidModel.getInputHistory() != null) {
-            builder.setRemoteInputHistory(androidModel.getInputHistory());
-          }
+            if (androidModel.getInputHistory() != null) {
+              builder.setRemoteInputHistory(androidModel.getInputHistory());
+            }
 
-          if (androidModel.getLights() != null) {
-            ArrayList<Integer> lights = androidModel.getLights();
-            builder.setLights(lights.get(0), lights.get(1), lights.get(2));
-          }
+            if (androidModel.getLights() != null) {
+              ArrayList<Integer> lights = androidModel.getLights();
+              builder.setLights(lights.get(0), lights.get(1), lights.get(2));
+            }
 
-          builder.setLocalOnly(androidModel.getLocalOnly());
+            builder.setLocalOnly(androidModel.getLocalOnly());
 
-          if (androidModel.getNumber() != null) {
-            builder.setNumber(androidModel.getNumber());
-          }
+            if (androidModel.getNumber() != null) {
+              builder.setNumber(androidModel.getNumber());
+            }
 
-          if (androidModel.getSound() != null) {
-            Uri soundUri = ResourceUtils.getSoundUri(androidModel.getSound());
-            if (soundUri != null) {
-              hasCustomSound = true;
-              builder.setSound(soundUri);
-            } else {
-              Logger.w(
-                  TAG,
-                  "Unable to retrieve sound for notification, sound was specified as: "
-                      + androidModel.getSound());
+            if (androidModel.getSound() != null) {
+              Uri soundUri = ResourceUtils.getSoundUri(androidModel.getSound());
+              if (soundUri != null) {
+                hasCustomSound = true;
+                builder.setSound(soundUri);
+              } else {
+                Logger.w(
+                    TAG,
+                    "Unable to retrieve sound for notification, sound was specified as: "
+                        + androidModel.getSound());
+              }
             }
-          }
 
-          builder.setDefaults(androidModel.getDefaults(hasCustomSound));
-          builder.setOngoing(androidModel.getOngoing());
-          builder.setOnlyAlertOnce(androidModel.getOnlyAlertOnce());
-          builder.setPriority(androidModel.getPriority());
+            builder.setDefaults(androidModel.getDefaults(hasCustomSound));
+            builder.setOngoing(androidModel.getOngoing());
+            builder.setOnlyAlertOnce(androidModel.getOnlyAlertOnce());
+            builder.setPriority(androidModel.getPriority());
 
-          NotificationAndroidModel.AndroidProgress progress = androidModel.getProgress();
-          if (progress != null) {
-            builder.setProgress(
-                progress.getMax(), progress.getCurrent(), progress.getIndeterminate());
-          }
+            NotificationAndroidModel.AndroidProgress progress = androidModel.getProgress();
+            if (progress != null) {
+              builder.setProgress(
+                  progress.getMax(), progress.getCurrent(), progress.getIndeterminate());
+            }
 
-          if (androidModel.getShortcutId() != null) {
-            builder.setShortcutId(androidModel.getShortcutId());
-          }
+            if (androidModel.getShortcutId() != null) {
+              builder.setShortcutId(androidModel.getShortcutId());
+            }
 
-          builder.setShowWhen(androidModel.getShowTimestamp());
+            builder.setShowWhen(androidModel.getShowTimestamp());
 
-          Integer smallIconId = androidModel.getSmallIcon();
-          if (smallIconId != null) {
-            Integer smallIconLevel = androidModel.getSmallIconLevel();
-            if (smallIconLevel != null) {
-              builder.setSmallIcon(smallIconId, smallIconLevel);
-            } else {
-              builder.setSmallIcon(smallIconId);
+            Integer smallIconId = androidModel.getSmallIcon();
+            if (smallIconId != null) {
+              Integer smallIconLevel = androidModel.getSmallIconLevel();
+              if (smallIconLevel != null) {
+                builder.setSmallIcon(smallIconId, smallIconLevel);
+              } else {
+                builder.setSmallIcon(smallIconId);
+              }
             }
-          }
 
-          if (androidModel.getSortKey() != null) {
-            builder.setSortKey(androidModel.getSortKey());
-          }
+            if (androidModel.getSortKey() != null) {
+              builder.setSortKey(androidModel.getSortKey());
+            }
 
-          if (androidModel.getTicker() != null) {
-            builder.setTicker(androidModel.getTicker());
-          }
+            if (androidModel.getTicker() != null) {
+              builder.setTicker(androidModel.getTicker());
+            }
 
-          if (androidModel.getTimeoutAfter() != null) {
-            builder.setTimeoutAfter(androidModel.getTimeoutAfter());
-          }
+            if (androidModel.getTimeoutAfter() != null) {
+              builder.setTimeoutAfter(androidModel.getTimeoutAfter());
+            }
 
-          builder.setUsesChronometer(androidModel.getShowChronometer());
+            builder.setUsesChronometer(androidModel.getShowChronometer());
 
-          long[] vibrationPattern = androidModel.getVibrationPattern();
-          if (vibrationPattern.length > 0) builder.setVibrate(vibrationPattern);
+            long[] vibrationPattern = androidModel.getVibrationPattern();
+            if (vibrationPattern.length > 0) builder.setVibrate(vibrationPattern);
 
-          builder.setVisibility(androidModel.getVisibility());
+            builder.setVisibility(androidModel.getVisibility());
 
-          long timestamp = androidModel.getTimestamp();
-          if (timestamp > -1) builder.setWhen(timestamp);
+            long timestamp = androidModel.getTimestamp();
+            if (timestamp > -1) builder.setWhen(timestamp);
 
-          builder.setAutoCancel(androidModel.getAutoCancel());
+            builder.setAutoCancel(androidModel.getAutoCancel());
 
-          return builder;
+            return builder;
+          } finally {
+            Trace.endSection();
+          }
         };
 
     /*
@@ -576,7 +583,8 @@ class NotificationManager {
                           Logger.e(
                               TAG,
                               "cancelAllNotificationsWithIds -> Failed to parse id as integer  "
-                                  + id);
+                                  + id,
+                              e);
                         }
 
                         if (integerId != null) {
@@ -619,47 +627,64 @@ class NotificationManager {
     return new ExtendedListenableFuture<>(notificationBundleToBuilder(notificationModel))
         .continueWith(
             (taskResult) -> {
-              NotificationCompat.Builder builder = taskResult;
+              Trace.beginSection("notifee:displayNotification");
+              try {
+                NotificationCompat.Builder builder = taskResult;
+
+                // Add the following extras for `getDisplayedNotifications()`
+                Bundle extrasBundle = new Bundle();
+                extrasBundle.putBundle(EXTRA_NOTIFEE_NOTIFICATION, notificationModel.toBundle());
+                if (triggerBundle != null) {
+                  extrasBundle.putBundle(EXTRA_NOTIFEE_TRIGGER, triggerBundle);
+                }
+                builder.addExtras(extrasBundle);
 
-              // Add the following extras for `getDisplayedNotifications()`
-              Bundle extrasBundle = new Bundle();
-              extrasBundle.putBundle(EXTRA_NOTIFEE_NOTIFICATION, notificationModel.toBundle());
-              if (triggerBundle != null) {
-                extrasBundle.putBundle(EXTRA_NOTIFEE_TRIGGER, triggerBundle);
-              }
-              builder.addExtras(extrasBundle);
+                NotificationAndroidModel androidBundle = notificationModel.getAndroid();
 
-              // build notification
-              Notification notification = Objects.requireNonNull(builder).build();
+                // Set foreground service behavior before building (only for FGS notifications).
+                // IMMEDIATE eliminates the 10-second display delay on Android 12+.
+                if (androidBundle.getAsForegroundService()) {
+                  builder.setForegroundServiceBehavior(
+                      androidBundle.getForegroundServiceBehavior());
+                }
 
-              int hashCode = notificationModel.getHashCode();
+                // build notification
+                Notification notification = Objects.requireNonNull(builder).build();
 
-              NotificationAndroidModel androidBundle = notificationModel.getAndroid();
-              if (androidBundle.getLoopSound()) {
-                notification.flags |= Notification.FLAG_INSISTENT;
-              }
+                int hashCode = notificationModel.getHashCode();
+                if (androidBundle.getLoopSound()) {
+                  notification.flags |= Notification.FLAG_INSISTENT;
+                }
 
-              if (androidBundle.getFlags() != null && androidBundle.getFlags().length > 0) {
-                for (int flag : androidBundle.getFlags()) {
-                  notification.flags |= flag;
+                if (androidBundle.getFlags() != null && androidBundle.getFlags().length > 0) {
+                  for (int flag : androidBundle.getFlags()) {
+                    notification.flags |= flag;
+                  }
                 }
-              }
 
-              if (androidBundle.getLightUpScreen()) {
-                PowerManagerUtils.lightUpScreenIfNeeded(ContextHolder.getApplicationContext());
-              }
+                if (androidBundle.getLightUpScreen()) {
+                  PowerManagerUtils.lightUpScreenIfNeeded(ContextHolder.getApplicationContext());
+                }
 
-              if (androidBundle.getAsForegroundService()) {
-                ForegroundService.start(hashCode, notification, notificationModel.toBundle());
-              } else {
-                NotificationManagerCompat.from(getApplicationContext())
-                    .notify(androidBundle.getTag(), hashCode, notification);
-              }
+                if (androidBundle.getAsForegroundService()) {
+                  Trace.beginSection("notifee:startForegroundService");
+                  try {
+                    ForegroundService.start(hashCode, notification, notificationModel.toBundle());
+                  } finally {
+                    Trace.endSection();
+                  }
+                } else {
+                  NotificationManagerCompat.from(getApplicationContext())
+                      .notify(androidBundle.getTag(), hashCode, notification);
+                }
 
-              EventBus.post(
-                  new NotificationEvent(NotificationEvent.TYPE_DELIVERED, notificationModel));
+                EventBus.post(
+                    new NotificationEvent(NotificationEvent.TYPE_DELIVERED, notificationModel));
 
-              return Futures.immediateFuture(null);
+                return Futures.immediateFuture(null);
+              } finally {
+                Trace.endSection();
+              }
             },
             CACHED_THREAD_POOL);
   }

package/android/src/main/java/app/notifee/core/WarmupHelper.java

@@ -0,0 +1,84 @@
+package app.notifee.core;
+
+/*
+ * Copyright (c) 2016-present Invertase Limited & Contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this library except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+import android.content.Context;
+import android.os.Trace;
+import androidx.core.app.NotificationManagerCompat;
+
+/**
+ * Encapsulates the foreground-service warmup logic so it can be called from both {@link
+ * InitProvider} (automatic, at app startup) and the JS bridge ({@code prewarmForegroundService()},
+ * on-demand).
+ *
+ * <p>This class runs <b>synchronously</b> on the caller's thread. Callers are responsible for
+ * choosing the appropriate thread/executor.
+ *
+ * <p>Safe to call multiple times (idempotent). After the first call, class loading is a no-op from
+ * ART's perspective and the Binder proxy call is cheap.
+ */
+@KeepForSdk
+public final class WarmupHelper {
+
+  private static final String TAG = "WarmupHelper";
+
+  static final String[] WARMUP_CLASSES = {
+    "app.notifee.core.ForegroundService",
+    "app.notifee.core.NotificationManager",
+    "app.notifee.core.model.NotificationModel",
+    "app.notifee.core.model.NotificationAndroidModel",
+    "app.notifee.core.model.ChannelModel",
+    "androidx.core.app.NotificationCompat$Builder",
+    "androidx.core.app.NotificationManagerCompat",
+  };
+
+  private WarmupHelper() {}
+
+  /**
+   * Pre-loads critical foreground-service classes and warms the INotificationManager Binder proxy.
+   * Runs synchronously on the caller's thread.
+   *
+   * @param context Application context used for class loading and Binder warmup.
+   */
+  @KeepForSdk
+  public static void runWarmup(Context context) {
+    Trace.beginSection("notifee:warmup");
+    try {
+      ClassLoader classLoader = context.getClassLoader();
+
+      // Pre-load critical foreground service classes to move ART class loading/verification
+      // cost from the first displayNotification() call to whenever the caller chooses.
+      for (String className : WARMUP_CLASSES) {
+        try {
+          Class.forName(className, true, classLoader);
+        } catch (ClassNotFoundException e) {
+          Logger.d(TAG, "Warmup class not found: " + className);
+        }
+      }
+
+      // Pre-warm INotificationManager Binder proxy by touching NotificationManagerCompat.
+      try {
+        NotificationManagerCompat.from(context).getNotificationChannels();
+      } catch (Exception e) {
+        Logger.d(TAG, "Warmup Binder pre-warm failed: " + e.getMessage());
+      }
+    } finally {
+      Trace.endSection();
+    }
+  }
+}

package/android/src/main/java/app/notifee/core/model/NotificationAndroidModel.java

@@ -74,6 +74,11 @@ public class NotificationAndroidModel {
         Objects.requireNonNull(
             mNotificationAndroidBundle.getParcelableArrayList("foregroundServiceTypes"));
 
+    if (foregroundServiceTypesArrayList.isEmpty()) {
+      Logger.w(TAG, "foregroundServiceTypes is empty; treating as absent");
+      return ServiceInfo.FOREGROUND_SERVICE_TYPE_MANIFEST;
+    }
+
     int foregroundServiceType = 0;
     for (int i = 0; i < foregroundServiceTypesArrayList.size(); i++) {
       foregroundServiceType |= ObjectUtils.getInt(foregroundServiceTypesArrayList.get(i));
@@ -97,6 +102,17 @@ public class NotificationAndroidModel {
     return mNotificationAndroidBundle.getBoolean("asForegroundService", false);
   }
 
+  /**
+   * Gets the foreground service behavior for the notification. Controls whether the foreground
+   * service notification is shown immediately or deferred on Android 12+.
+   *
+   * @return int matching a NotificationCompat.FOREGROUND_SERVICE_* constant
+   */
+  public int getForegroundServiceBehavior() {
+    return mNotificationAndroidBundle.getInt(
+        "foregroundServiceBehavior", NotificationCompat.FOREGROUND_SERVICE_DEFAULT);
+  }
+
   /**
    * Gets if the notification should light up the screen when displayed
    *
@@ -328,7 +344,7 @@ public class NotificationAndroidModel {
 
         return lights;
       } catch (Exception e) {
-        Logger.e(TAG, "getLights -> Failed to parse lights");
+        Logger.e(TAG, "getLights -> Failed to parse lights", e);
         return null;
       }
     }

package/android/src/main/kotlin/io/invertase/notifee/NotifeeApiModule.kt

@@ -317,6 +317,36 @@ class NotifeeApiModule(reactContext: ReactApplicationContext) :
             }
     }
 
+    override fun prewarmForegroundService(promise: Promise) {
+        val context = reactApplicationContext.applicationContext ?: run {
+            promise.reject("ERR_CONTEXT", "ReactApplicationContext is null")
+            return
+        }
+        val executor = java.util.concurrent.Executors.newSingleThreadExecutor { r ->
+            Thread(r, "notifee-prewarm").apply {
+                isDaemon = true
+                priority = Thread.MIN_PRIORITY
+            }
+        }
+        executor.submit {
+            android.os.Trace.beginSection("notifee:prewarm")
+            try {
+                app.notifee.core.WarmupHelper.runWarmup(context)
+                promise.resolve(null)
+            } catch (t: Throwable) {
+                // Best-effort semantics: warmup failures don't reject the promise.
+                // WarmupHelper logs and swallows internal errors; if something
+                // unexpectedly escapes, log it and still resolve so the JS-side
+                // await does not hang.
+                Logger.e("NotifeeApiModule", "prewarmForegroundService unexpectedly threw", t)
+                promise.resolve(null)
+            } finally {
+                android.os.Trace.endSection()
+            }
+        }
+        executor.shutdown()
+    }
+
     override fun hideNotificationDrawer() {
         NotifeeReactUtils.hideNotificationDrawer()
     }