probe

abstract suspend fun probe(address: String, tlsEnabled: Boolean, username: String?, password: String?): MqttProbeStatus(source)

Probe an MQTT broker to verify connectivity and credentials without joining the proxy lifecycle. Intended for UI "Test Connection" affordances.

Parameters

address

Raw broker address as the user would type it (host, host:port, or full URL).

tlsEnabled

true upgrades bare addresses to ssl:// (TLS, port 8883) instead of tcp:// (plaintext, port 1883); ignored when address already has a scheme.

username

Optional MQTT username.

password

Optional MQTT password.