guthls

type GlobalStats struct {
	Players   int
	TotalTime Seconds
}

type Leaderboard []UserLeaderboard

type LeaderboardQueryFlags uint8

type MySQLProvider struct {
	*sql.DB
}

type Provider interface {
	// User gets a user by Steam ID.
	User(SteamID) (*User, error)
	// Users gets all users.
	Users() ([]User, error)
	// LeaderboardForUser gets the user's leaderboard entry by Steam ID.
	LeaderboardForUser(SteamID, ...LeaderboardQueryFlags) (*UserLeaderboard, error)
	// Leaderboard gets the entire leaderboard. The returned leaderboard is
	// guaranteed to be sorted by Level then XP. If fetchUser is true, then the
	// returned UserLeaderboard instances should have the User field filled.
	Leaderboard(...LeaderboardQueryFlags) (Leaderboard, error)
	// GlobalStats gets the global server statistics.
	GlobalStats() (*GlobalStats, error)
}

type Seconds int

type SteamID string

type UnixTime int64

type User struct {
	SteamID    SteamID
	PlayerName string
	Team       string
	TotalTime  Seconds
	LastVisit  UnixTime
}

type UserLeaderboard struct {
	SteamID SteamID
	XP      int
	Level   int

	User *User  // only if LeaderboardQueryUser
	Rank string // only if LeaderboardQueryRank
}

type UserTimes []User