Summary

Adds a helper for channel recommendations (#1267).

channels.getChannelRecommendations (layer 227) has no offset or hash parameter, so the result genuinely can't be paginated through — the original issue's premise (paging to fetch all ~82 recommendations) isn't achievable via the API. What the server actually does, and what tdlib relies on, is:

• return the full list to Premium accounts;
• return a capped subset to non-Premium accounts, but as messages.chatsSlice whose count reports the true total.

So this helper returns the recommended channels together with that total Count, letting callers detect that more recommendations exist (e.g. to prompt for Premium):

type RecommendedChannels struct {
    Channels []peers.Channel
    Count    int // total available; may exceed len(Channels) for non-Premium
}

func (c Channel) RecommendedChannels(ctx) (RecommendedChannels, error)   // related to a channel
func (m *Manager) RecommendedChannels(ctx) (RecommendedChannels, error)  // for the current user

It applies the returned chats to the peers.Manager cache (consistent with the existing resolve helpers) and skips any non-channel chats while preserving the reported total.

Testing

Offline tgmock-based unit tests cover the error path, the messages.chats case (Count == len), the messages.chatsSlice case (Count reports the true total, e.g. 82), non-channel filtering, and the manager-level (no-channel) variant. Added a runnable compile-checked example. gofmt, go build ./..., go vet ./telegram/peers/, and go test -race ./telegram/peers/ all pass. No generated code changed; no network access.

Closes #1267

🤖 Generated with Claude Code