Added #

• iOS: connectToWifi now supports an optional readiness phase with new parameters:
  • waitForReady, probeHost, probePort, totalTimeout, step

Improved #

• iOS:
  • Treats alreadyAssociated as success when reconnecting to a known SSID.
  • Uses NEHotspotNetwork.fetchCurrent + TCP probe (Network framework) for robust readiness.
  • Single-call guard around FlutterResult to prevent double completion.
  • Clearer error mapping (INVALID_PASSWORD, PERMISSION_REQUIRED, UNAVAILABLE, etc.).
• Android (API 29+):
  • Added a timeout to ConnectivityManager.requestNetwork(..., timeoutMs) to avoid rare indefinite waits when the OS can’t attach.
  • Unbind the process (bindProcessToNetwork(null)) in onLost to cleanly release the hotspot route if the network disappears/roams.
  • Guard unbind against the last bound Network to avoid touching unrelated networks.

Fixed #

• iOS: Resolved the race where connectToWifi reported success but the first HTTP command failed with errno 51 (Network is unreachable).

Notes #

• No breaking API changes. Android changes only make failure/roam cases more deterministic.

Fixed #

• Android: Prevented rare crash in connectToWifi caused by multiple invocations of result.success/error due to network callback races. Now uses an AtomicBoolean guard to ensure only one result is returned.
• iOS: Prevented potential crash in connectToWifi by wrapping FlutterResult in a single-call-safe closure to avoid double invocation under race conditions.

Improved #

• Android: Finalized safe binding and callback cleanup during Wi-Fi connection flow, ensuring bindProcessToNetwork and unregisterNetworkCallback are used defensively.
• iOS: getCurrentSsid now gracefully handles missing permissions, unavailable interfaces, and unsupported cases with informative errors.
• Internal: Aligned native implementations for both platforms with consistent safeguards and cleaned up error handling.

Fixed #

• Properly unregisters the network callback in disconnectFromWifi on Android 10+ to fully release temporary Wi-Fi connections established via WifiNetworkSpecifier.
• Prevents lingering connections and ensures the system cleans up the app-bound network reliably after disconnect.

Improved #

• Strengthened disconnectFromWifi behavior on Android by combining bindProcessToNetwork(null) with unregisterNetworkCallback when applicable, as per platform requirements for Android 10+.

Fixed #

• Fixed a critical issue introduced in v1.2.0 where connectToWifi on Android incorrectly returned INVALID_PASSWORD due to unreliable SSID validation after connection.
• The plugin now trusts the system connection callback (onAvailable) on Android 10+ and does not rely on WifiManager.connectionInfo.ssid, which may return <unknown ssid>.
• Ensures proper use of UNAVAILABLE as a general error when the connection fails without specific cause.

Added #

• New OpWifiUtilsError.unavailable error type to represent general connection failures on Android (e.g., network out of range, wrong password, or timeout).

Changed #

• All result.success and result.error calls in Android native code are now wrapped in Handler(Looper.getMainLooper()).post { ... } to ensure safe main thread return.
• This change improves stability and avoids potential crashes or UI threading issues across different Android versions and manufacturers.
• Also avoids blocking the main thread while waiting for platform responses, improving compatibility with Flutter's MethodChannel behavior.

• Improved connectToWifi behavior on iOS:
  • Handles iOS error code 2 (invalid password format) and maps it to INVALID_PASSWORD.
  • Verifies actual connection by comparing current SSID after a short delay.
  • Distinguishes SSID_NOT_FOUND from other connection issues.
• Improved connectToWifi behavior on Android:
  • After onAvailable, verifies the actual connected SSID.
  • If the SSID doesn't match the expected one, returns INVALID_PASSWORD to indicate likely credential issues.

• README and pubspec wording improved for clarity and consistency

• Initial release 🎉
• Connect to Wi-Fi with optional password (iOS and Android)
• Disconnect from Wi-Fi network
• Check current connected SSID
• Full OpResult-based error handling
• joinOnce option supported on iOS
• Example app included for both platforms