[BIA3IA]

Summary

Bot side of PoliNetworkOrg/backend#98. People needs who administers each Telegram group, and Telegram is the only source (RFC v3 decision 2). The backend stores nothing: it asks the bot.

• Cache: the bot keeps each group's getChatAdministrators (without bots) in Redis (group_admins:<chatId>, through RedisFallbackAdapter, so it falls back to memory when Redis is down). Entries expire after a day, so a group the bot can no longer read becomes unknown instead of stale.
• Answering the backend: the socket event getGroupAdmins returns the cached admins of the requested groups, leaving out groups not read yet.
• Refresh:
  • when someone becomes or stops being an admin (chat_member), once a burst of changes in that chat settles (5 s);
  • 30 s after the bot is promoted in a group;
  • for every group 2 minutes after startup and every 6 hours, one Telegram request at a time (100 ms apart). A full refresh is skipped while another runs; a failing group keeps its previous entry and doesn't stop the others.

The middleware runs right after BotMembershipHandler, before the moderation handlers that end the chain on chat_member. The logic is in src/lib/group-admins with injected dependencies, so it is tested without Telegram, Redis or the backend.

⚠️ Draft until the backend is released

getGroupAdmins is not in the published @polinetwork/backend socket types yet, so CI typecheck fails on this branch. After backend#98 is merged and released, bump @polinetwork/backend here, then mark ready. Deploy the bot together with or before the backend: an older bot just doesn't answer, and People shows groups without admins.

Verification

Against the SDK built locally from backend#98:

• pnpm typecheck, biome check, pnpm build: OK.
• pnpm test: 192 passed, 1 skipped. New tests: who counts as an admin, which updates trigger a refresh, debouncing, failures keeping the previous entry, the full refresh, and the answer to the backend.

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}