feat(connectivity_plus): add ConnectivityResult.satellite on Android and iOS (#3771)

Co-authored-by: Jack Gibbons <jack@resolutionapp.co.nz>
Co-authored-by: Volodymyr Buberenko <vbuberen@users.noreply.github.com>

Author: 3 people

packages/connectivity_plus/connectivity_plus/README.md

@@ -56,6 +56,8 @@ if (connectivityResult.contains(ConnectivityResult.mobile)) {
   // It returns [other] on any device (also simulator)
 } else if (connectivityResult.contains(ConnectivityResult.bluetooth)) {
   // Bluetooth connection available.
+} else if (connectivityResult.contains(ConnectivityResult.satellite)) {
+  // Carrier-provided satellite network available
 } else if (connectivityResult.contains(ConnectivityResult.other)) {
   // Connected to a network which is not in the above mentioned networks.
 } else if (connectivityResult.contains(ConnectivityResult.none)) {
@@ -109,6 +111,7 @@ The following table shows which `ConnectivityResult` values are supported per pl
 | ethernet  | :white_check_mark: | :white_check_mark: |                    | :white_check_mark: | :white_check_mark: | :white_check_mark: |
 | mobile    | :white_check_mark: | :white_check_mark: |                    | :white_check_mark: |                    |                    |
 | vpn       | :white_check_mark: |                    |                    |                    | :white_check_mark: | :white_check_mark: |
+| satellite | :white_check_mark: | :white_check_mark: |                    |                    |                    |                    |
 | other     | :white_check_mark: | :white_check_mark: |                    | :white_check_mark: | :white_check_mark: | :white_check_mark: |
 
 _`none` is supported on all platforms by default._

packages/connectivity_plus/connectivity_plus/android/src/main/java/dev/fluttercommunity/plus/connectivity/Connectivity.java

@@ -20,6 +20,7 @@ public class Connectivity {
   static final String CONNECTIVITY_ETHERNET = "ethernet";
   static final String CONNECTIVITY_BLUETOOTH = "bluetooth";
   static final String CONNECTIVITY_VPN = "vpn";
+  static final String CONNECTIVITY_SATELLITE = "satellite";
   static final String CONNECTIVITY_OTHER = "other";
   private final ConnectivityManager connectivityManager;
 
@@ -67,6 +68,10 @@ List<String> getCapabilitiesList(NetworkCapabilities capabilities) {
     if (capabilities.hasTransport(NetworkCapabilities.TRANSPORT_BLUETOOTH)) {
       types.add(CONNECTIVITY_BLUETOOTH);
     }
+    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.VANILLA_ICE_CREAM
+        && capabilities.hasTransport(NetworkCapabilities.TRANSPORT_SATELLITE)) {
+      types.add(CONNECTIVITY_SATELLITE);
+    }
     if (types.isEmpty()
         && capabilities.hasCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)) {
       types.add(CONNECTIVITY_OTHER);

packages/connectivity_plus/connectivity_plus/ios/connectivity_plus/Sources/connectivity_plus/ConnectivityPlusPlugin.swift

@@ -54,6 +54,8 @@ public class ConnectivityPlusPlugin: NSObject, FlutterPlugin, FlutterStreamHandl
       return "mobile"
     case .wiredEthernet:
       return "ethernet"
+    case .satellite:
+      return "satellite"
     case .other:
         return "other"
     case .none:

packages/connectivity_plus/connectivity_plus/ios/connectivity_plus/Sources/connectivity_plus/ConnectivityProvider.swift

@@ -5,6 +5,7 @@ public enum ConnectivityType {
   case wiredEthernet
   case wifi
   case cellular
+  case satellite
   case other
 }
 

packages/connectivity_plus/connectivity_plus/ios/connectivity_plus/Sources/connectivity_plus/PathMonitorConnectivityProvider.swift

@@ -26,6 +26,9 @@ public class PathMonitorConnectivityProvider: NSObject, ConnectivityProvider {
       if path.usesInterfaceType(.other) {
         types.append(.other)
       }
+      if #available(iOS 26.0, *), path.isUltraConstrained {
+        types.append(.satellite)
+      }
     }
 
     return types.isEmpty ? [.none] : types

packages/connectivity_plus/connectivity_plus/macos/connectivity_plus/Sources/connectivity_plus/ConnectivityPlusPlugin.swift

@@ -55,6 +55,8 @@ public class ConnectivityPlusPlugin: NSObject, FlutterPlugin, FlutterStreamHandl
       return "mobile"
     case .wiredEthernet:
       return "ethernet"
+    case .satellite:
+      return "satellite"
     case .other:
         return "other"
     case .none:

packages/connectivity_plus/connectivity_plus/macos/connectivity_plus/Sources/connectivity_plus/ConnectivityProvider.swift

@@ -5,6 +5,7 @@ public enum ConnectivityType {
   case wiredEthernet
   case wifi
   case cellular
+  case satellite
   case other
 }
 

packages/connectivity_plus/connectivity_plus/macos/connectivity_plus/Sources/connectivity_plus/PathMonitorConnectivityProvider.swift

@@ -26,6 +26,9 @@ public class PathMonitorConnectivityProvider: NSObject, ConnectivityProvider {
       if path.usesInterfaceType(.other) {
         types.append(.other)
       }
+      if #available(macOS 26.0, *), path.isUltraConstrained {
+        types.append(.satellite)
+      }
     }
 
     return types.isEmpty ? [.none] : types

packages/connectivity_plus/connectivity_plus/test/connectivity_test.dart

@@ -12,6 +12,11 @@ const List<ConnectivityResult> kCheckConnectivityResult = [
   ConnectivityResult.wifi
 ];
 
+const List<ConnectivityResult> kCheckConnectivitySatelliteResult = [
+  ConnectivityResult.mobile,
+  ConnectivityResult.satellite,
+];
+
 void main() {
   group('Connectivity', () {
     late Connectivity connectivity;
@@ -26,6 +31,17 @@ void main() {
       final result = await connectivity.checkConnectivity();
       expect(result, kCheckConnectivityResult);
     });
+
+    test('checkConnectivity passes through satellite', () async {
+      final satellitePlatform = MockSatelliteConnectivityPlatform();
+      ConnectivityPlatform.instance = satellitePlatform;
+      connectivity = Connectivity();
+      final result = await connectivity.checkConnectivity();
+      expect(
+        result,
+        containsAll(kCheckConnectivitySatelliteResult),
+      );
+    });
   });
 }
 
@@ -37,3 +53,12 @@ class MockConnectivityPlatform extends Mock
     return kCheckConnectivityResult;
   }
 }
+
+class MockSatelliteConnectivityPlatform extends Mock
+    with MockPlatformInterfaceMixin
+    implements ConnectivityPlatform {
+  @override
+  Future<List<ConnectivityResult>> checkConnectivity() async {
+    return kCheckConnectivitySatelliteResult;
+  }
+}

packages/connectivity_plus/connectivity_plus_platform_interface/lib/src/enums.dart

@@ -22,6 +22,17 @@ enum ConnectivityResult {
   /// It returns [other] on any device (also simulator).
   vpn,
 
+  /// Satellite: Device is connected via a highly constrained satellite link.
+  ///
+  /// On iOS and macOS, reported when [NWPath.isUltraConstrained] is true.
+  /// Appears alongside [mobile] (e.g. `[mobile, satellite]`).
+  ///
+  /// On Android 15 (API 35) and newer, reported when [TRANSPORT_SATELLITE] capability
+  /// is present.
+  ///
+  /// Not reported on other platforms.
+  satellite,
+
   /// Other: Device is connected to an unknown network
   other
 }