Swift SDK for speedrun.com API

// Configure with API key
let config = SpeedrunConfiguration(
    apiKey: "your-api-key"
)
let client = SpeedrunClient(configuration: config)

// Access authenticated endpoints
let profile = try await client.profile.getProfile()
let notifications = try await client.profile.getNotifications()

do {
    let games = try await client.games.list()
} catch let error as SpeedrunError {
    switch error {
    case .networkError(let underlying):
        print("Network error: \(underlying)")
    case .rateLimitExceeded:
        print("Rate limit hit, retry later")
    case .httpError(let code, let message):
        print("HTTP \(code): \(message ?? "Unknown")")
    default:
        print("Error: \(error)")
    }
}

// Fetch all games with pagination
var allGames: [Game] = []
var offset = 0
let pageSize = 200

repeat {
    let page = try await client.games.list(
        query: GameQuery(max: pageSize, offset: offset)
    )
    
    allGames.append(contentsOf: page.data)
    
    if page.data.count < pageSize {
        break
    }
    
    offset += pageSize
} while true

print("Total games: \(allGames.count)")

// Fetch game with embedded data
let game = try await client.games.get(
    "sm64",
    embeds: [.categories, .levels, .variables]
)

// Access embedded data directly
for category in game.categories?.data ?? [] {
    print("Category: \(category.name)")
}

// Get leaderboard with player data
let leaderboard = try await client.leaderboards.fullGame(
    game: "sm64",
    category: "120-star",
    embeds: [.players]
)