lastfm

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

type Error struct {
	Code    int    `xml:"code,attr"`
	Message string `xml:",chardata"`
}

type FeedbackProvider interface {
	// LoveTrack should be called for tracks that have received a Thumbs-Up from the user
	LoveTrack(ctx context.Context, t pianobar.Track) error
	// UnLoveTrack should be called for tracks that have been banned or un-loved by the user
	UnLoveTrack(ctx context.Context, t pianobar.Track) error
}

type Request url.Values

type Response[T any] struct {
	Status string `xml:"status,attr"`
	Error  *Error `xml:"error,omitempty"`

	Value T `xml:",any,omitempty"`
}

type ScrobbleResult struct {
	Accepted int `xml:"accepted,attr"`
	Ignored  int `xml:"ignored,attr"`

	Tracks []Track `xml:"scrobble"`
}

type Scrobbler interface {
	// Scrobble emits the specified tracks to Last.FM's track.Scrobble API. Tracks must meet the following criteria to be
	// accepted by Last.FM:
	//
	// * The track must be at least 30s long
	// * The track must have been played for at least half of its duration, or for at least 4 minutes
	//
	// These criteria should be checked by the caller before calling Scrobble.
	//
	// Any non-terminal error should save the tracks to be retried on the next scrobble request. Up to 50 tracks may be
	// queued for a single request. If the provided context is cancelled before the request can be made to Last.FM's API
	// it will be retried on the next request. If it is cancelled after the request has been sent but before the
	// response can be read, it will not be retried later.
	Scrobble(ctx context.Context, t ...pianobar.Track) error

	// UpdateNowPlaying submits the specified track to Last.FM's track.updateNowPlaying API
	UpdateNowPlaying(ctx context.Context, t pianobar.Track) error
}

type Session struct {
	Name       string `xml:"name"`
	Key        string `xml:"key"`
	Subscriber int    `xml:"subscriber"`
}

type String struct {
	Corrected bool   `xml:"corrected,attr"`
	Value     string `xml:",chardata"`
}

type Track struct {
	Track       String `xml:"track"`
	Artist      String `xml:"artist"`
	Album       String `xml:"album"`
	AlbumArtist String `xml:"albumArtist,omitempty"`
	Timestamp   int    `xml:"timestamp"`

	IgnoreReason String `xml:"ignoreMessage,omitempty"`
}