yandex-music-api-go/internal/models/artist.go

// Package models provides data models for the Yandex Music API.
package models

import (
	"encoding/json"
)

// Artist represents a full artist from the Yandex Music API.
type Artist struct {
	BaseModel
	ID          JSONID       `json:"id"`
	Name        string       `json:"name"`
	CoverURI    string       `json:"cover_uri"`
	Genres      []string     `json:"genres"`
	Tracks      int          `json:"tracks"`
	Albums      int          `json:"albums"`
	Available   bool         `json:"available"`
	Composer    bool         `json:"composer"`
	Various     bool         `json:"various"`
	Decomposed  []Decomposed `json:"decomposed"`
	Ratings     *Ratings     `json:"ratings"`
	Counts      *Counts      `json:"counts"`
	Links       []Link       `json:"social_links"`
	Description *Description `json:"description"`
	// Additional fields
	IDForFrom  string             `json:"id_for_from"`
	Cover      *Cover             `json:"cover"`
	BriefInfo  *ArtistBriefInfo   `json:"brief_info"`
	DonationInfo *ArtistDonationInfo `json:"donation_info"`
	Concerts   []Concert          `json:"concerts"`
	Clips      []Clip             `json:"clips"`
	Similar    []Artist           `json:"similar"`
	AlbumsData []Album            `json:"albums_data"`
	TracksData []Track            `json:"tracks_data"`
}

// DeJSON deserializes an Artist from JSON data.
func (a *Artist) DeJSON(data []byte, c ClientInterface) (Model, error) {
	var raw map[string]json.RawMessage
	if err := json.Unmarshal(data, &raw); err != nil {
		return nil, err
	}

	artist := &Artist{BaseModel: *NewBaseModel(c)}

	// Simple fields
	if v, ok := raw["id"]; ok {
		json.Unmarshal(v, &artist.ID)
	}
	if v, ok := raw["name"]; ok {
		json.Unmarshal(v, &artist.Name)
	}
	if v, ok := raw["cover_uri"]; ok {
		json.Unmarshal(v, &artist.CoverURI)
	}
	if v, ok := raw["genres"]; ok {
		json.Unmarshal(v, &artist.Genres)
	}
	if v, ok := raw["tracks"]; ok {
		json.Unmarshal(v, &artist.Tracks)
	}
	if v, ok := raw["albums"]; ok {
		json.Unmarshal(v, &artist.Albums)
	}
	if v, ok := raw["available"]; ok {
		json.Unmarshal(v, &artist.Available)
	}
	if v, ok := raw["composer"]; ok {
		json.Unmarshal(v, &artist.Composer)
	}
	if v, ok := raw["various"]; ok {
		json.Unmarshal(v, &artist.Various)
	}
	if v, ok := raw["id_for_from"]; ok {
		json.Unmarshal(v, &artist.IDForFrom)
	}

	// Nested objects
	if v, ok := raw["decomposed"]; ok {
		var decomposed []Decomposed
		if err := json.Unmarshal(v, &decomposed); err == nil {
			artist.Decomposed = decomposed
		}
	}
	if v, ok := raw["ratings"]; ok {
		var ratings Ratings
		json.Unmarshal(v, &ratings)
		artist.Ratings = &ratings
	}
	if v, ok := raw["counts"]; ok {
		var counts Counts
		json.Unmarshal(v, &counts)
		artist.Counts = &counts
	}
	if v, ok := raw["social_links"]; ok {
		var links []Link
		if err := json.Unmarshal(v, &links); err == nil {
			artist.Links = links
		}
	}
	if v, ok := raw["cover"]; ok {
		var cover Cover
		json.Unmarshal(v, &cover)
		artist.Cover = &cover
	}
	if v, ok := raw["brief_info"]; ok {
		var brief ArtistBriefInfo
		json.Unmarshal(v, &brief)
		artist.BriefInfo = &brief
	}
	if v, ok := raw["donation_info"]; ok {
		var donation ArtistDonationInfo
		json.Unmarshal(v, &donation)
		artist.DonationInfo = &donation
	}
	if v, ok := raw["concerts"]; ok {
		var concerts []Concert
		json.Unmarshal(v, &concerts)
		artist.Concerts = concerts
	}
	if v, ok := raw["clips"]; ok {
		var clips []Clip
		json.Unmarshal(v, &clips)
		artist.Clips = clips
	}
	if v, ok := raw["similar"]; ok {
		var similar []Artist
		json.Unmarshal(v, &similar)
		artist.Similar = similar
	}
	if v, ok := raw["albums"]; ok {
		var albums []Album
		json.Unmarshal(v, &albums)
		artist.AlbumsData = albums
	}
	if v, ok := raw["tracks"]; ok {
		var tracks []Track
		json.Unmarshal(v, &tracks)
		artist.TracksData = tracks
	}

	return artist, nil
}

// DeList deserializes a list of Artists from JSON data.
func (a *Artist) DeList(data []byte, c ClientInterface) ([]Model, error) {
	var rawList []json.RawMessage
	if err := json.Unmarshal(data, &rawList); err != nil {
		return nil, err
	}

	result := make([]Model, 0, len(rawList))
	for _, item := range rawList {
		artist := &Artist{BaseModel: *NewBaseModel(c)}
		if err := json.Unmarshal(item, artist); err != nil {
			continue
		}
		result = append(result, artist)
	}
	return result, nil
}

// Ratings represents artist ratings.
type Ratings struct {
	Rating int    `json:"rating"`
	Votes  int    `json:"votes"`
	Week   int    `json:"week"`
	Day    int    `json:"day"`
}

// Counts represents artist counts.
type Counts struct {
	Tracks  int `json:"tracks"`
	Albums  int `json:"albums"`
	Folders int `json:"folders"`
}

// SocialLink represents a social media link.
type SocialLink struct {
	URL   string `json:"url"`
	Title string `json:"title"`
	Type  string `json:"type"`
}

// Cover represents cover image info.
type Cover struct {
	URI        string `json:"uri"`
	Type       string `json:"type"`
	Prefix     string `json:"prefix"`
	Pattern    string `json:"pattern"`
	Background string `json:"background"`
}

// ArtistBriefInfo represents brief artist info.
type ArtistBriefInfo struct {
	Description string `json:"description"`
	Available   bool   `json:"available"`
}

// ArtistDonations represents artist donations info.
type ArtistDonations struct {
	Items  []DonationItem `json:"items"`
	Total  int            `json:"total"`
	Goal   int            `json:"goal"`
	Raised int            `json:"raised"`
}

// DonationItem represents a donation item.
type DonationItem struct {
	ID          JSONID `json:"id"`
	Title       string `json:"title"`
	Description string `json:"description"`
	Amount      int    `json:"amount"`
	Goal        int    `json:"goal"`
	Raised      int    `json:"raised"`
	Currency    string `json:"currency"`
}

// Decomposed represents a decomposed artist that can be either a string or an Artist object.
type Decomposed struct {
	Artist *Artist `json:"-"`
	Str    string  `json:"-"`
	IsStr  bool    `json:"-"`
}

// UnmarshalJSON implements json.Unmarshaler, accepting both string and Artist object.
func (d *Decomposed) UnmarshalJSON(data []byte) error {
	var s string
	if err := json.Unmarshal(data, &s); err == nil {
		d.Str = s
		d.IsStr = true
		return nil
	}
	var artist Artist
	if err := json.Unmarshal(data, &artist); err != nil {
		return err
	}
	d.Artist = &artist
	d.IsStr = false
	return nil
}

// MarshalJSON implements json.Marshaler.
func (d Decomposed) MarshalJSON() ([]byte, error) {
	if d.IsStr {
		return json.Marshal(d.Str)
	}
	return json.Marshal(d.Artist)
}

// Link represents a link to an artist's official page or social network.
type Link struct {
	BaseModel
	Title         string `json:"title"`
	Href          string `json:"href"`
	Type          string `json:"type"`
	SocialNetwork string `json:"social_network"`
}

// DeJSON deserializes Link from JSON data.
func (l *Link) DeJSON(data []byte, c ClientInterface) (Model, error) {
	var raw map[string]json.RawMessage
	if err := json.Unmarshal(data, &raw); err != nil {
		return nil, err
	}

	link := &Link{BaseModel: *NewBaseModel(c)}

	if v, ok := raw["title"]; ok {
		json.Unmarshal(v, &link.Title)
	}
	if v, ok := raw["href"]; ok {
		json.Unmarshal(v, &link.Href)
	}
	if v, ok := raw["type"]; ok {
		json.Unmarshal(v, &link.Type)
	}
	if v, ok := raw["social_network"]; ok {
		json.Unmarshal(v, &link.SocialNetwork)
	}

	return link, nil
}

// DeList deserializes a list of Links from JSON data.
func (l *Link) DeList(data []byte, c ClientInterface) ([]Model, error) {
	var rawList []json.RawMessage
	if err := json.Unmarshal(data, &rawList); err != nil {
		return nil, err
	}

	result := make([]Model, 0, len(rawList))
	for _, item := range rawList {
		link := &Link{BaseModel: *NewBaseModel(c)}
		if err := json.Unmarshal(item, link); err != nil {
			continue
		}
		result = append(result, link)
	}
	return result, nil
}

// Description represents artist description.
type Description struct {
	BaseModel
	Text string `json:"text"`
	URI  string `json:"uri"`
}

// DeJSON deserializes Description from JSON data.
func (d *Description) DeJSON(data []byte, c ClientInterface) (Model, error) {
	var raw map[string]json.RawMessage
	if err := json.Unmarshal(data, &raw); err != nil {
		return nil, err
	}

	desc := &Description{BaseModel: *NewBaseModel(c)}

	if v, ok := raw["text"]; ok {
		json.Unmarshal(v, &desc.Text)
	}
	if v, ok := raw["uri"]; ok {
		json.Unmarshal(v, &desc.URI)
	}

	return desc, nil
}

// DeList deserializes a list of Descriptions from JSON data.
func (d *Description) DeList(data []byte, c ClientInterface) ([]Model, error) {
	var rawList []json.RawMessage
	if err := json.Unmarshal(data, &rawList); err != nil {
		return nil, err
	}

	result := make([]Model, 0, len(rawList))
	for _, item := range rawList {
		desc := &Description{BaseModel: *NewBaseModel(c)}
		if err := json.Unmarshal(item, desc); err != nil {
			continue
		}
		result = append(result, desc)
	}
	return result, nil
}

// ArtistDonationInfo represents artist donation info.
type ArtistDonationInfo struct {
	BaseModel
	Title string `json:"title"`
	URL   string `json:"url"`
}

// DeJSON deserializes ArtistDonationInfo from JSON data.
func (adi *ArtistDonationInfo) DeJSON(data []byte, c ClientInterface) (Model, error) {
	var raw map[string]json.RawMessage
	if err := json.Unmarshal(data, &raw); err != nil {
		return nil, err
	}

	info := &ArtistDonationInfo{BaseModel: *NewBaseModel(c)}

	if v, ok := raw["title"]; ok {
		json.Unmarshal(v, &info.Title)
	}
	if v, ok := raw["url"]; ok {
		json.Unmarshal(v, &info.URL)
	}

	return info, nil
}

// DeList deserializes a list of ArtistDonationInfo from JSON data.
func (adi *ArtistDonationInfo) DeList(data []byte, c ClientInterface) ([]Model, error) {
	var rawList []json.RawMessage
	if err := json.Unmarshal(data, &rawList); err != nil {
		return nil, err
	}

	result := make([]Model, 0, len(rawList))
	for _, item := range rawList {
		info := &ArtistDonationInfo{BaseModel: *NewBaseModel(c)}
		if err := json.Unmarshal(item, info); err != nil {
			continue
		}
		result = append(result, info)
	}
	return result, nil
}

// ConcertShort represents a concert (minimal for artist).
type ConcertShort struct {
	BaseModel
	ID JSONID `json:"id"`
	Title     string `json:"title"`
	Date      string `json:"date"`
	Venue     string `json:"venue"`
	Location  string `json:"location"`
	TicketURI string `json:"ticket_uri"`
	ImageURI  string `json:"image_uri"`
	MinPrice  int    `json:"min_price"`
	MaxPrice  int    `json:"max_price"`
	Available bool   `json:"available"`
}

// DeJSON deserializes a ConcertShort from JSON data.
func (c *ConcertShort) DeJSON(data []byte, client ClientInterface) (Model, error) {
	var raw map[string]json.RawMessage
	if err := json.Unmarshal(data, &raw); err != nil {
		return nil, err
	}

	concert := &ConcertShort{BaseModel: *NewBaseModel(client)}

	if v, ok := raw["id"]; ok {
		json.Unmarshal(v, &concert.ID)
	}
	if v, ok := raw["title"]; ok {
		json.Unmarshal(v, &concert.Title)
	}
	if v, ok := raw["date"]; ok {
		json.Unmarshal(v, &concert.Date)
	}
	if v, ok := raw["venue"]; ok {
		json.Unmarshal(v, &concert.Venue)
	}
	if v, ok := raw["location"]; ok {
		json.Unmarshal(v, &concert.Location)
	}
	if v, ok := raw["ticket_uri"]; ok {
		json.Unmarshal(v, &concert.TicketURI)
	}
	if v, ok := raw["image_uri"]; ok {
		json.Unmarshal(v, &concert.ImageURI)
	}
	if v, ok := raw["min_price"]; ok {
		json.Unmarshal(v, &concert.MinPrice)
	}
	if v, ok := raw["max_price"]; ok {
		json.Unmarshal(v, &concert.MaxPrice)
	}
	if v, ok := raw["available"]; ok {
		json.Unmarshal(v, &concert.Available)
	}

	return concert, nil
}

// DeList deserializes a list of ConcertShort from JSON data.
func (c *ConcertShort) DeList(data []byte, client ClientInterface) ([]Model, error) {
	var rawList []json.RawMessage
	if err := json.Unmarshal(data, &rawList); err != nil {
		return nil, err
	}

	result := make([]Model, 0, len(rawList))
	for _, item := range rawList {
		concert := &ConcertShort{BaseModel: *NewBaseModel(client)}
		if err := json.Unmarshal(item, concert); err != nil {
			continue
		}
		result = append(result, concert)
	}
	return result, nil
}

// ClipShort represents a clip (minimal for artist).
type ClipShort struct {
	BaseModel
	ID JSONID `json:"id"`
	Title      string `json:"title"`
	Duration   int    `json:"duration"`
	CoverURI   string `json:"cover_uri"`
	PreviewURI string `json:"preview_uri"`
	Available  bool   `json:"available"`
	Views      int    `json:"views"`
	Likes      int    `json:"likes"`
	CreatedAt  string `json:"created_at"`
}

// DeJSON deserializes a ClipShort from JSON data.
func (c *ClipShort) DeJSON(data []byte, client ClientInterface) (Model, error) {
	var raw map[string]json.RawMessage
	if err := json.Unmarshal(data, &raw); err != nil {
		return nil, err
	}

	clip := &ClipShort{BaseModel: *NewBaseModel(client)}

	if v, ok := raw["id"]; ok {
		json.Unmarshal(v, &clip.ID)
	}
	if v, ok := raw["title"]; ok {
		json.Unmarshal(v, &clip.Title)
	}
	if v, ok := raw["duration"]; ok {
		json.Unmarshal(v, &clip.Duration)
	}
	if v, ok := raw["cover_uri"]; ok {
		json.Unmarshal(v, &clip.CoverURI)
	}
	if v, ok := raw["preview_uri"]; ok {
		json.Unmarshal(v, &clip.PreviewURI)
	}
	if v, ok := raw["available"]; ok {
		json.Unmarshal(v, &clip.Available)
	}
	if v, ok := raw["views"]; ok {
		json.Unmarshal(v, &clip.Views)
	}
	if v, ok := raw["likes"]; ok {
		json.Unmarshal(v, &clip.Likes)
	}
	if v, ok := raw["created_at"]; ok {
		json.Unmarshal(v, &clip.CreatedAt)
	}

	return clip, nil
}

// DeList deserializes a list of ClipShort from JSON data.
func (c *ClipShort) DeList(data []byte, client ClientInterface) ([]Model, error) {
	var rawList []json.RawMessage
	if err := json.Unmarshal(data, &rawList); err != nil {
		return nil, err
	}

	result := make([]Model, 0, len(rawList))
	for _, item := range rawList {
		clip := &ClipShort{BaseModel: *NewBaseModel(client)}
		if err := json.Unmarshal(item, clip); err != nil {
			continue
		}
		result = append(result, clip)
	}
	return result, nil
}