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

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

import (
	"encoding/json"
)

// Track represents a full track from the Yandex Music API.
type Track struct {
	BaseModel
	ID                       JSONID           `json:"id"`
	Title                    string           `json:"title"`
	DurationMs               int              `json:"duration_ms"`
	StorageDir               string           `json:"storage_dir"`
	CoverURI                 string           `json:"cover_uri"`
	Artists                  []Artist         `json:"artists"`
	Albums                   []Album          `json:"albums"`
	Genre                    string           `json:"genre"`
	Version                  string           `json:"version"`
	Explicit                 bool             `json:"explicit"`
	Available                bool             `json:"available"`
	AvailableForPremiumUsers bool             `json:"available_for_premium_users"`
	R128                     *R128            `json:"r128"`
	TrackSharingFlag         string           `json:"track_sharing_flag"`
	Major                    *Major           `json:"major"`
	LyricsInfo               *TrackLyricsInfo `json:"lyrics_info"`
	SimilarTracks            []Track        `json:"similar_tracks"`
	DownloadInfo             []DownloadInfo   `json:"download_info"`
}

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

	track := &Track{BaseModel: *NewBaseModel(c)}

	// Simple fields
	if v, ok := raw["id"]; ok {
		json.Unmarshal(v, &track.ID)
	}
	if v, ok := raw["title"]; ok {
		json.Unmarshal(v, &track.Title)
	}
	if v, ok := raw["duration_ms"]; ok {
		json.Unmarshal(v, &track.DurationMs)
	}
	if v, ok := raw["storage_dir"]; ok {
		json.Unmarshal(v, &track.StorageDir)
	}
	if v, ok := raw["cover_uri"]; ok {
		json.Unmarshal(v, &track.CoverURI)
	}
	if v, ok := raw["genre"]; ok {
		json.Unmarshal(v, &track.Genre)
	}
	if v, ok := raw["version"]; ok {
		json.Unmarshal(v, &track.Version)
	}
	if v, ok := raw["explicit"]; ok {
		json.Unmarshal(v, &track.Explicit)
	}
	if v, ok := raw["available"]; ok {
		json.Unmarshal(v, &track.Available)
	}
	if v, ok := raw["available_for_premium_users"]; ok {
		json.Unmarshal(v, &track.AvailableForPremiumUsers)
	}
	if v, ok := raw["r128"]; ok {
		json.Unmarshal(v, &track.R128)
	}
	if v, ok := raw["track_sharing_flag"]; ok {
		json.Unmarshal(v, &track.TrackSharingFlag)
	}

	// Nested objects
	if v, ok := raw["artists"]; ok {
		var artists []Artist
		if err := json.Unmarshal(v, &artists); err == nil {
			track.Artists = artists
		}
	}
	if v, ok := raw["albums"]; ok {
		var albums []Album
		if err := json.Unmarshal(v, &albums); err == nil {
			track.Albums = albums
		}
	}
	if v, ok := raw["major"]; ok {
		var major Major
		if err := json.Unmarshal(v, &major); err == nil {
			track.Major = &major
		}
	}
	if v, ok := raw["lyrics_info"]; ok {
		var lyrics TrackLyricsInfo
		if err := json.Unmarshal(v, &lyrics); err == nil {
			track.LyricsInfo = &lyrics
		}
	}
	if v, ok := raw["similar_tracks"]; ok {
		var similar []Track
		if err := json.Unmarshal(v, &similar); err == nil {
			track.SimilarTracks = similar
		}
	}
	if v, ok := raw["download_info"]; ok {
		var downloadInfo []DownloadInfo
		if err := json.Unmarshal(v, &downloadInfo); err == nil {
			track.DownloadInfo = downloadInfo
		}
	}

	return track, nil
}

// DeList deserializes a list of Tracks from JSON data.
func (t *Track) 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 {
		track := &Track{BaseModel: *NewBaseModel(c)}
		if err := json.Unmarshal(item, track); err != nil {
			continue
		}
		result = append(result, track)
	}
	return result, nil
}

// GetDownloadInfo returns download info for a specific quality, or nil if not found.
func (t *Track) GetDownloadInfo(quality string) *DownloadInfo {
	for _, info := range t.DownloadInfo {
		if info.Quality == quality {
			return &info
		}
	}
	return nil
}

// Note: Artist and Album types are defined in their respective files
// These are imported automatically since they're in the same package

// Major represents major label info for a track.
type Major struct {
	ID          JSONID `json:"id"`
	Name        string `json:"name"`
	Description string `json:"description"`
}

// Lyrics represents track lyrics from supplement endpoint.
type Lyrics struct {
	BaseModel
	ID              JSONID `json:"id"`
	Text            string `json:"lyrics"`
	FullLyrics      string `json:"full_lyrics"`
	HasRights       bool   `json:"has_rights"`
	ShowTranslation bool   `json:"show_translation"`
	TextLanguage    string `json:"text_language"`
	URL             string `json:"url"`
	Major           *Major `json:"major"`
}

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

	lyrics := &Lyrics{BaseModel: *NewBaseModel(c)}

	if v, ok := raw["id"]; ok {
		json.Unmarshal(v, &lyrics.ID)
	}
	if v, ok := raw["lyrics"]; ok {
		json.Unmarshal(v, &lyrics.Text)
	}
	if v, ok := raw["full_lyrics"]; ok {
		json.Unmarshal(v, &lyrics.FullLyrics)
	}
	if v, ok := raw["has_rights"]; ok {
		json.Unmarshal(v, &lyrics.HasRights)
	}
	if v, ok := raw["show_translation"]; ok {
		json.Unmarshal(v, &lyrics.ShowTranslation)
	}
	if v, ok := raw["text_language"]; ok {
		json.Unmarshal(v, &lyrics.TextLanguage)
	}
	if v, ok := raw["url"]; ok {
		json.Unmarshal(v, &lyrics.URL)
	}
	if v, ok := raw["major"]; ok {
		var major Major
		json.Unmarshal(v, &major)
		lyrics.Major = &major
	}

	return lyrics, nil
}

// DeList deserializes a list of Lyrics from JSON data.
func (l *Lyrics) 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 {
		lyrics := &Lyrics{BaseModel: *NewBaseModel(c)}
		if err := json.Unmarshal(item, lyrics); err != nil {
			continue
		}
		result = append(result, lyrics)
	}
	return result, nil
}

// TrackLyricsInfo represents lyrics availability info for a track.
type TrackLyricsInfo struct {
	BaseModel
	HasAvailableSyncLyrics  bool `json:"has_available_sync_lyrics"`
	HasAvailableTextLyrics  bool `json:"has_available_text_lyrics"`
}

// DeJSON deserializes TrackLyricsInfo from JSON data.
func (tli *TrackLyricsInfo) 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 := &TrackLyricsInfo{BaseModel: *NewBaseModel(c)}

	if v, ok := raw["has_available_sync_lyrics"]; ok {
		json.Unmarshal(v, &info.HasAvailableSyncLyrics)
	}
	if v, ok := raw["has_available_text_lyrics"]; ok {
		json.Unmarshal(v, &info.HasAvailableTextLyrics)
	}

	return info, nil
}

// DeList deserializes a list of TrackLyricsInfo from JSON data.
func (tli *TrackLyricsInfo) 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 := &TrackLyricsInfo{BaseModel: *NewBaseModel(c)}
		if err := json.Unmarshal(item, info); err != nil {
			continue
		}
		result = append(result, info)
	}
	return result, nil
}
// DownloadInfo represents file download info for a track.
type DownloadInfo struct {
	Quality         string `json:"quality"`
	Codec           string `json:"codec"`
	Bitrate         int    `json:"bitrate"`
	Size            int64  `json:"size"`
	URL             string `json:"url"`
	DirectLink      bool   `json:"direct_link"`
	DownloadInfoURL string `json:"download_info_url"`
	DirectLinkURL   string `json:"-"` // Computed signed download URL
}