ServerSelector.h

//
// Interactive server picker and standalone latency prober.
//

#ifndef SPEEDTEST_SERVERSELECTOR_H
#define SPEEDTEST_SERVERSELECTOR_H

#include <string>
#include <vector>
#include "DataTypes.h"

// Result of a single latency probe. Sub-millisecond resolution, unlike
// SpeedTestClient::ping(), so nearby servers stay distinguishable.
typedef struct probe_result_t {
    enum State { Untested, Queued, Testing, Ok, Failed, Unsupported };
    State       state      = Untested;
    double      latency_ms = 0.0;
    std::string version;
} ProbeResult;

// Case-insensitive substring match against city, sponsor, country and host.
bool serverMatches(const ServerInfo& server, const std::string& needle);
std::vector<ServerInfo> filterServers(const std::vector<ServerInfo>& servers, const std::string& needle);

// Connects, handshakes and pings a single server. Fully self-contained: every
// socket operation has a hard timeout, so it is safe to run from worker threads.
ProbeResult probeServer(const ServerInfo& server, int samples = 4, int timeout_ms = 2000);

// Probes every given server in parallel and blocks until all are done.
std::vector<ProbeResult> probeServers(const std::vector<ServerInfo>& servers, const std::string& minVersion);

// Full-screen picker. Returns false when the user aborts (q / Esc / Ctrl-C).
bool selectServerInteractive(const std::vector<ServerInfo>& servers,
                             const IPInfo& client,
                             const std::string& initialFilter,
                             const std::string& minVersion,
                             ServerInfo& chosen);

// Renders the same table non-interactively.
void printServerTable(const std::vector<ServerInfo>& servers,
                      const std::vector<ProbeResult>& results,
                      const IPInfo& client);

bool stdinIsInteractive();

#endif //SPEEDTEST_SERVERSELECTOR_H