speedtest

type Config struct {
	ServerURL    string        // base URL, e.g. "http://localhost:8080"
	HTTPClient   *http.Client  // optional; one is built if nil
	PingSamples  int           // default 10
	TestDuration time.Duration // per phase, default 10s
	Streams      int           // parallel HTTP streams per phase, default 4
	ChunkBytes   int64         // bytes per request in download/upload, default 25 MiB
	SampleEvery  time.Duration // how often to emit a Sample, default 100ms
}

type Phase string

type Result struct {
	PingMs       float64       `json:"ping_ms"`
	JitterMs     float64       `json:"jitter_ms"`
	DownloadMbps float64       `json:"download_mbps"`
	UploadMbps   float64       `json:"upload_mbps"`
	BytesDown    int64         `json:"bytes_down"`
	BytesUp      int64         `json:"bytes_up"`
	Duration     time.Duration `json:"duration"`
	StartedAt    time.Time     `json:"started_at"`
}

type Sample struct {
	Phase   Phase
	Elapsed time.Duration // time since the phase began
	Bytes   int64         // cumulative bytes for download/upload
	Mbps    float64       // instantaneous bits/sec, megabits
	PingMs  float64       // most-recent RTT for the ping phase
}