feat: add business account profile photo methods

SetBusinessAccountProfilePhoto (photos.uploadProfilePhoto, static or animated)
and RemoveBusinessAccountProfilePhoto (photos.updateProfilePhoto with
inputPhotoEmpty), both via the business-connection wrapper. is_public maps to
the MTProto Fallback (public/fallback photo). Adds the InputProfilePhoto union.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: ernado

business_photo.go

@@ -0,0 +1,102 @@
+package botapi
+
+import (
+	"context"
+
+	"github.com/gotd/td/tg"
+)
+
+// InputProfilePhoto is a sealed union describing a profile photo to set on a
+// managed business account.
+//
+// Concrete variants: InputProfilePhotoStatic, InputProfilePhotoAnimated.
+type InputProfilePhoto interface {
+	isInputProfilePhoto()
+}
+
+// InputProfilePhotoStatic is a static profile photo.
+type InputProfilePhotoStatic struct {
+	// Photo is the static profile photo, an uploaded file (file_id and URL are
+	// not accepted by Telegram for profile photos).
+	Photo InputFile
+}
+
+// InputProfilePhotoAnimated is an animated profile photo (a short video).
+type InputProfilePhotoAnimated struct {
+	// Animation is the animated profile photo, an uploaded file.
+	Animation InputFile
+	// MainFrameTimestamp is the timestamp in seconds of the frame used as a
+	// static profile photo. Defaults to the start of the animation.
+	MainFrameTimestamp float64
+}
+
+func (InputProfilePhotoStatic) isInputProfilePhoto()   {}
+func (InputProfilePhotoAnimated) isInputProfilePhoto() {}
+
+// uploadProfileFile uploads a profile photo file. Profile photos must be raw
+// uploads; a file_id or URL references an existing document and cannot back the
+// InputFile the profile-photo RPCs need.
+func (b *Bot) uploadProfileFile(ctx context.Context, f InputFile) (tg.InputFileClass, error) {
+	up, ok := f.(*InputFileUpload)
+	if !ok {
+		return nil, &Error{Code: 400, Description: "Bad Request: profile photo must be an uploaded file"}
+	}
+
+	return b.uploadInputFile(ctx, up)
+}
+
+// SetBusinessAccountProfilePhoto changes the profile photo of a managed business
+// account. When isPublic is true the photo is set as the public (fallback) photo,
+// shown to users who cannot see the account's main photo. The bot must have the
+// can_edit_profile_photo business bot right.
+//
+// The switch over the sealed InputProfilePhoto union is exhaustive
+// (gochecksumtype).
+func (b *Bot) SetBusinessAccountProfilePhoto(
+	ctx context.Context, businessConnectionID string, photo InputProfilePhoto, isPublic bool,
+) error {
+	req := &tg.PhotosUploadProfilePhotoRequest{}
+
+	switch p := photo.(type) {
+	case InputProfilePhotoStatic:
+		file, err := b.uploadProfileFile(ctx, p.Photo)
+		if err != nil {
+			return err
+		}
+
+		req.SetFile(file)
+	case InputProfilePhotoAnimated:
+		video, err := b.uploadProfileFile(ctx, p.Animation)
+		if err != nil {
+			return err
+		}
+
+		req.SetVideo(video)
+
+		if p.MainFrameTimestamp != 0 {
+			req.SetVideoStartTs(p.MainFrameTimestamp)
+		}
+	default:
+		return &Error{Code: 400, Description: "Bad Request: invalid profile photo"}
+	}
+
+	if isPublic {
+		req.SetFallback(true)
+	}
+
+	return b.invokeBusiness(ctx, businessConnectionID, req, &tg.PhotosPhoto{})
+}
+
+// RemoveBusinessAccountProfilePhoto removes the profile photo of a managed
+// business account. When isPublic is true the public (fallback) photo is removed
+// instead of the main one. The bot must have the can_edit_profile_photo business
+// bot right.
+func (b *Bot) RemoveBusinessAccountProfilePhoto(ctx context.Context, businessConnectionID string, isPublic bool) error {
+	req := &tg.PhotosUpdateProfilePhotoRequest{ID: &tg.InputPhotoEmpty{}}
+
+	if isPublic {
+		req.SetFallback(true)
+	}
+
+	return b.invokeBusiness(ctx, businessConnectionID, req, &tg.PhotosPhoto{})
+}

business_photo_test.go

@@ -0,0 +1,114 @@
+package botapi
+
+import (
+	"context"
+	"testing"
+
+	"github.com/gotd/td/tg"
+)
+
+func TestSetBusinessAccountProfilePhotoStatic(t *testing.T) {
+	inv := newMockInvoker()
+	inv.reply(tg.InvokeWithBusinessConnectionRequestTypeID, &tg.PhotosPhoto{Photo: &tg.PhotoEmpty{}})
+
+	photo := InputProfilePhotoStatic{Photo: &InputFileUpload{Name: "p.jpg", Bytes: []byte("img")}}
+	if err := newMockBot(inv).SetBusinessAccountProfilePhoto(context.Background(), "bc1", photo, true); err != nil {
+		t.Fatalf("SetBusinessAccountProfilePhoto: %v", err)
+	}
+
+	wrapper := tg.InvokeWithBusinessConnectionRequest{Query: &tg.PhotosUploadProfilePhotoRequest{}}
+
+	inv.decode(t, tg.InvokeWithBusinessConnectionRequestTypeID, &wrapper)
+
+	if wrapper.ConnectionID != "bc1" {
+		t.Fatalf("connection id = %q", wrapper.ConnectionID)
+	}
+
+	req, ok := wrapper.Query.(*tg.PhotosUploadProfilePhotoRequest)
+	if !ok {
+		t.Fatalf("query = %#v", wrapper.Query)
+	}
+
+	if _, ok := req.GetFile(); !ok {
+		t.Fatal("static photo should set File")
+	}
+
+	if !req.GetFallback() {
+		t.Fatal("is_public should set Fallback")
+	}
+}
+
+func TestSetBusinessAccountProfilePhotoAnimated(t *testing.T) {
+	inv := newMockInvoker()
+	inv.reply(tg.InvokeWithBusinessConnectionRequestTypeID, &tg.PhotosPhoto{Photo: &tg.PhotoEmpty{}})
+
+	photo := InputProfilePhotoAnimated{
+		Animation:          &InputFileUpload{Name: "a.mp4", Bytes: []byte("vid")},
+		MainFrameTimestamp: 1.5,
+	}
+	if err := newMockBot(inv).SetBusinessAccountProfilePhoto(context.Background(), "bc1", photo, false); err != nil {
+		t.Fatalf("SetBusinessAccountProfilePhoto: %v", err)
+	}
+
+	wrapper := tg.InvokeWithBusinessConnectionRequest{Query: &tg.PhotosUploadProfilePhotoRequest{}}
+
+	inv.decode(t, tg.InvokeWithBusinessConnectionRequestTypeID, &wrapper)
+
+	req, ok := wrapper.Query.(*tg.PhotosUploadProfilePhotoRequest)
+	if !ok {
+		t.Fatalf("query = %#v", wrapper.Query)
+	}
+
+	if _, ok := req.GetVideo(); !ok {
+		t.Fatal("animated photo should set Video")
+	}
+
+	if ts, ok := req.GetVideoStartTs(); !ok || ts != 1.5 {
+		t.Fatalf("video start ts = %v, ok=%v", ts, ok)
+	}
+
+	if req.GetFallback() {
+		t.Fatal("Fallback should be unset when is_public is false")
+	}
+}
+
+func TestSetBusinessAccountProfilePhotoRejectsFileID(t *testing.T) {
+	inv := newMockInvoker()
+
+	photo := InputProfilePhotoStatic{Photo: FileID("abc")}
+
+	err := newMockBot(inv).SetBusinessAccountProfilePhoto(context.Background(), "bc1", photo, false)
+	if err == nil {
+		t.Fatal("expected error for non-upload profile photo")
+	}
+
+	if inv.count() != 0 {
+		t.Fatal("should not make an RPC for an invalid file")
+	}
+}
+
+func TestRemoveBusinessAccountProfilePhoto(t *testing.T) {
+	inv := newMockInvoker()
+	inv.reply(tg.InvokeWithBusinessConnectionRequestTypeID, &tg.PhotosPhoto{Photo: &tg.PhotoEmpty{}})
+
+	if err := newMockBot(inv).RemoveBusinessAccountProfilePhoto(context.Background(), "bc1", true); err != nil {
+		t.Fatalf("RemoveBusinessAccountProfilePhoto: %v", err)
+	}
+
+	wrapper := tg.InvokeWithBusinessConnectionRequest{Query: &tg.PhotosUpdateProfilePhotoRequest{}}
+
+	inv.decode(t, tg.InvokeWithBusinessConnectionRequestTypeID, &wrapper)
+
+	req, ok := wrapper.Query.(*tg.PhotosUpdateProfilePhotoRequest)
+	if !ok {
+		t.Fatalf("query = %#v", wrapper.Query)
+	}
+
+	if _, ok := req.ID.(*tg.InputPhotoEmpty); !ok {
+		t.Fatalf("id = %#v, want empty", req.ID)
+	}
+
+	if !req.GetFallback() {
+		t.Fatal("is_public should set Fallback")
+	}
+}