Fixed #

• Swift Package Manager (SPM) support for iOS and macOS to restore full pub.dev score: added FlutterFramework dependency to iOS Package.swift and migrated macOS to the SPM-compatible macos/connectivity_validator/Sources/ layout with its own Package.swift

Added #

• macOS support (10.14+) using native NWPathMonitor plus the same HTTPS validation probe as iOS. Requires the com.apple.security.network.client sandbox entitlement (see README).

Changed #

• Added a Cloudflare (cp.cloudflare.com/generate_204) probe fallback so validation works in regions where Google endpoints are blocked (Android, iOS and macOS)
• Only HTTP 204 from generate_204 endpoints counts as validated connectivity, closing a captive-portal false positive where 3xx redirects were treated as online
• Added pub.dev topics and a clearer package description for discoverability

Fixed #

• False "offline" results on high-latency mobile networks by increasing the HTTPS probe timeout from 500ms to 2s (Android and iOS)
• Flaky online/offline toggling with debounced offline reporting: requires 2 independent offline signals before emitting false; unambiguous offline (no active network) still emits immediately
• Stale NET_CAPABILITY_VALIDATED (Android) and NWPath .satisfied (iOS) no longer report online during periodic checks — HTTPS probe result is authoritative
• Captive portal false positives: only HTTP 204 from generate_204 endpoints counts as validated connectivity (Android and iOS)
• Android resource leak on engine detach (network callback and executor now cleaned up on hot restart)

Changed #

• onConnectivityChanged stream filters consecutive duplicate values via .distinct() so listeners only see actual state changes

Added #

• Get status on-demand: getConnectivityStatus to get current connectivity once without subscribing to the stream (use when you need a single check, e.g. on button tap, instead of listening)

Added #

• Support details for Swift Package Manager in documentation

Changed #

• Enhanced README for clarity
• Updated podspec and pubspec.lock for dependency versions

Added #

• Swift Package Manager (SPM) support: Added Package.swift for iOS to support Swift Package Manager alongside CocoaPods
• Full SPM compatibility while maintaining CocoaPods backward compatibility

Changed #

• Updated iOS plugin structure to support both CocoaPods and Swift Package Manager
• Podspec updated to point to new SPM-compatible source file locations

Changed #

• SDK compatibility: Relaxed Dart SDK constraint from ^3.10.7 to ">=3.0.0 <4.0.0" for broader compatibility with Flutter projects

Fixed #

• Code formatting improvements in Android plugin implementation

Added #

• Initial release of connectivity_validator plugin
• Validated connectivity checking: Detects real internet access, not just network connection
• Captive portal detection: Identifies when connected to WiFi but behind a captive portal
• Real-time updates: Stream-based API (onConnectivityChanged) for continuous connectivity monitoring
• Android implementation:
  • Uses ConnectivityManager.NetworkCallback for real-time network monitoring
  • Checks NET_CAPABILITY_INTERNET and NET_CAPABILITY_VALIDATED capabilities
  • Sends initial state immediately when stream is listened to
  • Optimized to only emit updates when connectivity state actually changes
• iOS implementation:
  • Uses NWPathMonitor for network path monitoring
  • Checks .satisfied status to detect validated connectivity
  • Handles network state changes on background queue
  • Sends updates to Flutter on main thread
• Example app:
  • Complete working example demonstrating plugin usage
  • GetX-based state management example with NetworkStatusController
  • Visual indicators (icons and colors) for connectivity status
  • Real-time UI updates using reactive state management
• Comprehensive documentation:
  • Detailed README with installation instructions
  • Multiple state management examples (StreamBuilder, GetX, Provider, Riverpod, BLoC, ValueNotifier)
  • API reference documentation
  • Platform-specific implementation details
  • Best practices and troubleshooting guide

Technical Details #

• Channel name: connectivity_validator/status (consistent across all platforms)
• Zero dependencies: Plugin itself has no external dependencies
• Framework-agnostic: Works with any state management solution
• Optimized: Prevents duplicate emissions by tracking last state
• Thread-safe: Properly handles main thread requirements for Flutter communication

Platform Support #

• ✅ Android (API 24+)
• ✅ iOS (iOS 12.0+)