feat: GetUserPersonalChatMessages

messages.getPersonalChannelHistory returns the latest messages from a user's
linked personal channel, converted to Bot API Messages (newest-first). Mapping
confirmed against telegram-bot-api 10.1. Hermetic tests; lint clean.

Author: ernado

get_personal_messages.go

@@ -0,0 +1,54 @@
+package botapi
+
+import (
+	"context"
+	"math"
+
+	"github.com/gotd/td/tg"
+)
+
+// GetUserPersonalChatMessages returns the most recent messages, up to limit,
+// from the personal channel a user has linked to their profile. The messages are
+// returned newest-first.
+func (b *Bot) GetUserPersonalChatMessages(ctx context.Context, userID int64, limit int) ([]*Message, error) {
+	if limit <= 0 {
+		return nil, &Error{Code: 400, Description: "Bad Request: limit must be positive"}
+	}
+
+	user, err := b.resolveInputUser(ctx, userID)
+	if err != nil {
+		return nil, err
+	}
+
+	res, err := b.raw.MessagesGetPersonalChannelHistory(ctx, &tg.MessagesGetPersonalChannelHistoryRequest{
+		UserID: user,
+		Limit:  limit,
+		MaxID:  math.MaxInt32,
+	})
+	if err != nil {
+		return nil, asAPIError(err)
+	}
+
+	msgs, ok := res.AsModified()
+	if !ok {
+		return nil, nil
+	}
+
+	out := make([]*Message, 0, len(msgs.GetMessages()))
+
+	for _, m := range msgs.GetMessages() {
+		msg, ok := m.(*tg.Message)
+		if !ok {
+			continue
+		}
+
+		converted, err := b.convertMessage(ctx, msg)
+		if err != nil {
+			return nil, err
+		}
+
+		out = append(out, converted)
+	}
+
+	return out, nil
+}

get_personal_messages_test.go

@@ -0,0 +1,47 @@
+package botapi
+
+import (
+	"context"
+	"testing"
+
+	"github.com/gotd/td/tg"
+)
+
+func TestGetUserPersonalChatMessages(t *testing.T) {
+	inv := newMockInvoker()
+	inv.reply(tg.MessagesGetPersonalChannelHistoryRequestTypeID, &tg.MessagesMessages{
+		Messages: []tg.MessageClass{
+			&tg.Message{ID: 7, Message: "hello", PeerID: &tg.PeerUser{UserID: 99}},
+		},
+		Users: []tg.UserClass{&tg.User{ID: 99, AccessHash: 1}},
+	})
+
+	got, err := newMockBot(inv).GetUserPersonalChatMessages(context.Background(), 99, 10)
+	if err != nil {
+		t.Fatalf("GetUserPersonalChatMessages: %v", err)
+	}
+
+	if len(got) != 1 || got[0].MessageID != 7 || got[0].Text != "hello" {
+		t.Fatalf("messages = %#v", got)
+	}
+
+	var req tg.MessagesGetPersonalChannelHistoryRequest
+
+	inv.decode(t, tg.MessagesGetPersonalChannelHistoryRequestTypeID, &req)
+
+	if req.Limit != 10 {
+		t.Fatalf("limit = %d", req.Limit)
+	}
+}
+
+func TestGetUserPersonalChatMessagesBadLimit(t *testing.T) {
+	inv := newMockInvoker()
+
+	if _, err := newMockBot(inv).GetUserPersonalChatMessages(context.Background(), 99, 0); err == nil {
+		t.Fatal("expected error for non-positive limit")
+	}
+
+	if inv.count() != 0 {
+		t.Fatalf("made %d RPC calls, want 0", inv.count())
+	}
+}