feat: GetUserProfileAudios

users.getSavedMusic returns the audios a user has added to their profile, each
converted via the shared document classifier. New UserProfileAudios result type
with offset/limit options. Mapping confirmed against telegram-bot-api 10.1.
Hermetic test; lint clean.

Author: ernado

user_profile_audios.go

@@ -0,0 +1,88 @@
+package botapi
+
+import (
+	"context"
+
+	"github.com/gotd/td/fileid"
+	"github.com/gotd/td/tg"
+)
+
+// UserProfileAudios is the result of GetUserProfileAudios: the audios a user has
+// added to their profile.
+type UserProfileAudios struct {
+	// TotalCount is the total number of profile audios the user has.
+	TotalCount int `json:"total_count"`
+	// Audios are the requested profile audios.
+	Audios []Audio `json:"audios"`
+}
+
+// GetUserProfileAudiosOption configures GetUserProfileAudios.
+type GetUserProfileAudiosOption func(*profileAudiosConfig)
+
+type profileAudiosConfig struct {
+	offset int
+	limit  int
+}
+
+// WithProfileAudiosOffset sets the number of audios to skip.
+func WithProfileAudiosOffset(offset int) GetUserProfileAudiosOption {
+	return func(c *profileAudiosConfig) { c.offset = offset }
+}
+
+// WithProfileAudiosLimit caps the number of audios returned (1-100).
+func WithProfileAudiosLimit(limit int) GetUserProfileAudiosOption {
+	return func(c *profileAudiosConfig) { c.limit = limit }
+}
+
+// audioFromDocument builds a Bot API Audio from an MTProto audio document,
+// reusing the shared document classifier.
+func audioFromDocument(d *tg.Document) Audio {
+	var m Message
+
+	setDocumentMedia(d, &m)
+
+	if m.Audio != nil {
+		return *m.Audio
+	}
+
+	fileID, uniqueID := encodeFileID(fileid.FromDocument(d))
+
+	return Audio{FileID: fileID, FileUniqueID: uniqueID, MIMEType: d.MimeType, FileSize: d.Size}
+}
+
+// GetUserProfileAudios returns the audios a user has added to their profile.
+func (b *Bot) GetUserProfileAudios(ctx context.Context, userID int64, opts ...GetUserProfileAudiosOption) (*UserProfileAudios, error) {
+	cfg := profileAudiosConfig{limit: 100}
+	for _, o := range opts {
+		o(&cfg)
+	}
+
+	user, err := b.resolveInputUser(ctx, userID)
+	if err != nil {
+		return nil, err
+	}
+
+	res, err := b.raw.UsersGetSavedMusic(ctx, &tg.UsersGetSavedMusicRequest{
+		ID:     user,
+		Offset: cfg.offset,
+		Limit:  cfg.limit,
+	})
+	if err != nil {
+		return nil, asAPIError(err)
+	}
+
+	music, ok := res.(*tg.UsersSavedMusic)
+	if !ok {
+		return &UserProfileAudios{}, nil
+	}
+
+	out := &UserProfileAudios{TotalCount: music.Count, Audios: make([]Audio, 0, len(music.Documents))}
+
+	for _, doc := range music.Documents {
+		if d, ok := doc.(*tg.Document); ok {
+			out.Audios = append(out.Audios, audioFromDocument(d))
+		}
+	}
+
+	return out, nil
+}

user_profile_audios_test.go

@@ -0,0 +1,44 @@
+package botapi
+
+import (
+	"context"
+	"testing"
+
+	"github.com/gotd/td/tg"
+)
+
+func TestGetUserProfileAudios(t *testing.T) {
+	inv := newMockInvoker()
+	inv.reply(tg.UsersGetSavedMusicRequestTypeID, &tg.UsersSavedMusic{
+		Count: 3,
+		Documents: []tg.DocumentClass{
+			&tg.Document{
+				ID: 1, AccessHash: 2, FileReference: []byte{0}, MimeType: "audio/mpeg", Size: 1000, DCID: 2,
+				Attributes: []tg.DocumentAttributeClass{
+					&tg.DocumentAttributeAudio{Duration: 180, Title: "Song", Performer: "Artist"},
+				},
+			},
+		},
+	})
+
+	got, err := newMockBot(inv).GetUserProfileAudios(context.Background(), 99, WithProfileAudiosLimit(50), WithProfileAudiosOffset(5))
+	if err != nil {
+		t.Fatalf("GetUserProfileAudios: %v", err)
+	}
+
+	if got.TotalCount != 3 || len(got.Audios) != 1 {
+		t.Fatalf("got = %#v", got)
+	}
+
+	if got.Audios[0].Duration != 180 || got.Audios[0].Title != "Song" || got.Audios[0].Performer != "Artist" {
+		t.Fatalf("audio = %#v", got.Audios[0])
+	}
+
+	var req tg.UsersGetSavedMusicRequest
+
+	inv.decode(t, tg.UsersGetSavedMusicRequestTypeID, &req)
+
+	if req.Limit != 50 || req.Offset != 5 {
+		t.Fatalf("req = %#v", req)
+	}
+}