// 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 string `json:"id"` Name string `json:"name"` CoverURI string `json:"cover_uri"` Genres []string `json:"genres"` Tracks int `json:"tracks"` Albums int `json:"albums"` Link string `json:"link"` Available bool `json:"available"` Description string `json:"description"` Composer bool `json:"composer"` Various bool `json:"various"` Decomposed []Artist `json:"decomposed"` Ratings *Ratings `json:"ratings"` Counts *Counts `json:"counts"` SocialLinks []SocialLink `json:"social_links"` // Additional fields IDForFrom string `json:"id_for_from"` Cover *Cover `json:"cover"` BriefInfo *ArtistBriefInfo `json:"brief_info"` Donations *ArtistDonations `json:"donations"` 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["link"]; ok { json.Unmarshal(v, &artist.Link) } if v, ok := raw["available"]; ok { json.Unmarshal(v, &artist.Available) } if v, ok := raw["description"]; ok { json.Unmarshal(v, &artist.Description) } 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 []Artist json.Unmarshal(v, &decomposed) 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 []SocialLink json.Unmarshal(v, &links) artist.SocialLinks = 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["donations"]; ok { var donations ArtistDonations json.Unmarshal(v, &donations) artist.Donations = &donations } 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 float64 `json:"rating"` Votes int `json:"votes"` } // 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 string `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"` } // ConcertShort represents a concert (minimal for artist). type ConcertShort struct { BaseModel ID string `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 string `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 }