Files
yandex-music-api-go/internal/models/artist.go
T
Mrixs dbb823ade3 Fix R128 and remaining ID fields to accept both JSON types
- Track.R128 and TrackShort.R128: float64 → JSONR128 (accepts both JSON number and object)
- All remaining primary ID fields: string → JSONID (accepts both JSON string and number)
  Fixed in: account, artist, clip, concert, feed, label, landing, metatag,
  music_history, pin, queue, radio, search, settings, supplement
2026-10-18 11:01:26 +03:00

369 lines
9.5 KiB
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"`
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 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"`
}
// 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
}