From 5fb308ba60d58e1f192803a19ca80e95b41f8317 Mon Sep 17 00:00:00 2001
From: jonathanedey <jedey@google.com>
Date: Tue, 3 Mar 2026 12:49:07 -0500
Subject: [PATCH] feat(fcm): Add support for restricted satellite API

---
 .../firebase/messaging/AndroidConfig.java     | 18 +++++++++++--
 .../firebase/messaging/MessageTest.java       | 26 +++++++++++++++++--
 2 files changed, 40 insertions(+), 4 deletions(-)

diff --git a/src/main/java/com/google/firebase/messaging/AndroidConfig.java b/src/main/java/com/google/firebase/messaging/AndroidConfig.java
index 941793479..22f591680 100644
--- a/src/main/java/com/google/firebase/messaging/AndroidConfig.java
+++ b/src/main/java/com/google/firebase/messaging/AndroidConfig.java
@@ -58,6 +58,9 @@ public class AndroidConfig {
   @Key("bandwidth_constrained_ok")
   private final Boolean bandwidthConstrainedOk;
 
+  @Key("restricted_satellite_ok")
+  private final Boolean restrictedSatelliteOk;
+
   private AndroidConfig(Builder builder) {
     this.collapseKey = builder.collapseKey;
     if (builder.priority != null) {
@@ -83,6 +86,7 @@ private AndroidConfig(Builder builder) {
     this.fcmOptions = builder.fcmOptions;
     this.directBootOk = builder.directBootOk;
     this.bandwidthConstrainedOk = builder.bandwidthConstrainedOk;
+    this.restrictedSatelliteOk = builder.restrictedSatelliteOk;
   }
 
   /**
@@ -113,6 +117,7 @@ public static class Builder {
     private AndroidFcmOptions fcmOptions;
     private Boolean directBootOk;
     private Boolean bandwidthConstrainedOk;
+    private Boolean restrictedSatelliteOk;
 
     private Builder() {}
 
@@ -224,14 +229,23 @@ public Builder setDirectBootOk(boolean directBootOk) {
     }
 
     /**
-     * Sets the {@code bandwidth_constrained_ok} flag. If set to true, messages can be delivered
-     * even when the device is connected through a bandwidth-constrained network.
+     * Sets the {@code bandwidth_constrained_ok} flag. If set to true, messages will be allowed
+     * to be delivered to the app while the device is on a bandwidth constrained network.
      */
     public Builder setBandwidthConstrainedOk(boolean bandwidthConstrainedOk) {
       this.bandwidthConstrainedOk = bandwidthConstrainedOk;
       return this;
     }
 
+    /**
+     * Sets the {@code restricted_satellite_ok} flag. If set to true, messages will be allowed
+     * to be delivered to the app while the device is on a restricted satellite network.
+     */
+    public Builder setRestrictedSatelliteOk(boolean restrictedSatelliteOk) {
+      this.restrictedSatelliteOk = restrictedSatelliteOk;
+      return this;
+    }
+
     /**
      * Creates a new {@link AndroidConfig} instance from the parameters set on this builder.
      *
diff --git a/src/test/java/com/google/firebase/messaging/MessageTest.java b/src/test/java/com/google/firebase/messaging/MessageTest.java
index 70d130032..94ca4fa4a 100644
--- a/src/test/java/com/google/firebase/messaging/MessageTest.java
+++ b/src/test/java/com/google/firebase/messaging/MessageTest.java
@@ -20,7 +20,6 @@
 import static org.junit.Assert.assertSame;
 import static org.junit.Assert.fail;
 
-import com.google.api.client.googleapis.util.Utils;
 import com.google.api.client.json.JsonFactory;
 import com.google.api.client.json.JsonParser;
 import com.google.common.collect.ImmutableList;
@@ -247,6 +246,29 @@ public void testAndroidMessageWithBandwidthConstrainedOk() throws IOException {
     assertJsonEquals(ImmutableMap.of("topic", "test-topic", "android", data), message);
   }
 
+  @Test
+  public void testAndroidMessageWithRestrictedSatelliteOk() throws IOException {
+    Message message = Message.builder()
+        .setAndroidConfig(AndroidConfig.builder()
+            .setRestrictedSatelliteOk(true)
+            .setNotification(AndroidNotification.builder()
+                .setTitle("android-title")
+                .setBody("android-body")
+                .build())
+            .build())
+        .setTopic("test-topic")
+        .build();
+    Map<String, Object> notification = ImmutableMap.<String, Object>builder()
+        .put("title", "android-title")
+        .put("body", "android-body")
+        .build();
+    Map<String, Object> data = ImmutableMap.of(
+        "restricted_satellite_ok", true,
+        "notification", notification
+    );
+    assertJsonEquals(ImmutableMap.of("topic", "test-topic", "android", data), message);
+  }
+
   @Test(expected = IllegalArgumentException.class)
   public void testAndroidNotificationWithNegativeCount() throws IllegalArgumentException {
     AndroidNotification.builder().setNotificationCount(-1).build();
@@ -991,7 +1013,7 @@ public void testExtendedAndroidNotificationParameters() throws IOException {
   }
 
   private static void assertJsonEquals(
-      Map expected, Object actual) throws IOException {
+      Map<String, Object> expected, Object actual) throws IOException {
     assertEquals(expected, toMap(actual));
   }