Adding "broken" event for when connection permanently goes down

Also documenting the "reconnecting" event