feat(fcm): Add bandwidthConstrainedOk and restrictedSatelliteOk (#2994)

* feat(messaging): Add bandwidthConstrainedOk and restrictedSatelliteOk to AndroidConfig

Adds two new optional boolean properties, `bandwidthConstrainedOk` and `restrictedSatelliteOk`, to the `AndroidConfig` type in the messaging API.

This change includes:
- Updating the `AndroidConfig` interface in `src/messaging/messaging-api.ts`.
- Adding the corresponding property mappings in `src/messaging/messaging-internal.ts`.
- Updating unit tests in `test/unit/messaging/messaging.spec.ts` to cover the new properties.

* feat(messaging): Add bandwidthConstrainedOk and restrictedSatelliteOk to AndroidConfig

Adds two new optional boolean properties, `bandwidthConstrainedOk` and `restrictedSatelliteOk`, to the `AndroidConfig` type in the messaging API.

This change includes:
- Updating the `AndroidConfig` interface in `src/messaging/messaging-api.ts`.
- Adding the corresponding property mappings in `src/messaging/messaging-internal.ts`.
- Updating unit tests in `test/unit/messaging/messaging.spec.ts` to cover the new properties.
- Updating the public API documentation.

* fix docstrings

---------

Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>

Author: lahirumaramba

etc/firebase-admin.messaging.api.md

@@ -8,6 +8,7 @@ import { Agent } from 'http';
 
 // @public
 export interface AndroidConfig {
+    bandwidthConstrainedOk?: boolean;
     collapseKey?: string;
     data?: {
         [key: string]: string;
@@ -17,6 +18,7 @@ export interface AndroidConfig {
     notification?: AndroidNotification;
     priority?: ('high' | 'normal');
     restrictedPackageName?: string;
+    restrictedSatelliteOk?: boolean;
     ttl?: number;
 }
 

src/messaging/messaging-api.ts

@@ -428,6 +428,18 @@ export interface AndroidConfig {
   * the app while the device is in direct boot mode.
   */
   directBootOk?: boolean;
+
+  /**
+   * A boolean indicating whether messages will be allowed to be delivered to  
+   * the app while the device is on a bandwidth constrained network.
+   */
+  bandwidthConstrainedOk?: boolean;
+
+  /**
+   * A boolean indicating whether messages will be allowed to be delivered to  
+   * the app while the device is on a restricted satellite network.
+   */
+  restrictedSatelliteOk?: boolean;
 }
 
 /**

src/messaging/messaging-internal.ts

@@ -422,6 +422,8 @@ function validateAndroidConfig(config: AndroidConfig | undefined): void {
     collapseKey: 'collapse_key',
     restrictedPackageName: 'restricted_package_name',
     directBootOk: 'direct_boot_ok',
+    bandwidthConstrainedOk: 'bandwidth_constrained_ok',
+    restrictedSatelliteOk: 'restricted_satellite_ok',
   };
   renameProperties(config, propertyMappings);
 }

test/unit/messaging/messaging.spec.ts

@@ -1899,6 +1899,8 @@ describe('Messaging', () => {
             collapseKey: 'test.key',
             restrictedPackageName: 'test.package',
             directBootOk: true,
+            bandwidthConstrainedOk: true,
+            restrictedSatelliteOk: true,
             notification: {
               clickAction: 'test.click.action',
               titleLocKey: 'title.loc.key',
@@ -1927,6 +1929,8 @@ describe('Messaging', () => {
             collapse_key: 'test.key',
             restricted_package_name: 'test.package',
             direct_boot_ok: true,
+            bandwidth_constrained_ok: true,
+            restricted_satellite_ok: true,
             notification: {
               click_action: 'test.click.action',
               title_loc_key: 'title.loc.key',
@@ -1983,6 +1987,8 @@ describe('Messaging', () => {
             collapseKey: 'test.key',
             restrictedPackageName: 'test.package',
             directBootOk: true,
+            bandwidthConstrainedOk: true,
+            restrictedSatelliteOk: true,
             ttl: 5,
             data: {
               k1: 'v1',
@@ -2031,6 +2037,8 @@ describe('Messaging', () => {
             collapse_key: 'test.key',
             restricted_package_name: 'test.package',
             direct_boot_ok: true,
+            bandwidth_constrained_ok: true,
+            restricted_satellite_ok: true,
             ttl: '0.005000000s', // 5 ms = 5,000,000 ns
             data: {
               k1: 'v1',