webapi

type APIError struct {
	Status  int
	Message string
}

type Album struct {
	URI         string   `json:"uri"`
	Name        string   `json:"name"`
	Artists     []Artist `json:"artists"`
	ReleaseDate string   `json:"release_date"`
	TotalTracks int      `json:"total_tracks"`
	Images      []Image  `json:"images"`
}

type Artist struct {
	URI    string  `json:"uri"`
	Name   string  `json:"name"`
	Images []Image `json:"images"`
}

type Client struct {
	// contains filtered or unexported fields
}

type Image struct {
	URL   string `json:"url"`
	Width *int   `json:"width"`
}

type Login struct {
	URL string
	// contains filtered or unexported fields
}

type Page[T any] struct {
	Items []T `json:"items"`
	Total int `json:"total"`
}

type Playlist struct {
	URI    string  `json:"uri"`
	Name   string  `json:"name"`
	Images []Image `json:"images"`
	Owner  struct {
		DisplayName string `json:"display_name"`
	} `json:"owner"`
	// The February 2026 API renamed "tracks" to "items". Both are read.
	Tracks *struct {
		Total int `json:"total"`
	} `json:"tracks"`
	Items *struct {
		Total int `json:"total"`
	} `json:"items"`
}

type RateLimitError struct {
	RetryAfter time.Duration
	Reason     string
}

type SearchResult struct {
	Tracks    Page[Track]     `json:"tracks"`
	Albums    Page[Album]     `json:"albums"`
	Artists   Page[Artist]    `json:"artists"`
	Playlists Page[*Playlist] `json:"playlists"`
}

type Track struct {
	URI        string   `json:"uri"`
	Name       string   `json:"name"`
	DurationMs int      `json:"duration_ms"`
	Artists    []Artist `json:"artists"`
	Album      Album    `json:"album"`
}