"""Telegram's Channels-page card (Desktop + web dashboard): the PlatformEntry ``dashboard_*`` /
``docs_url`` fields register() spreads in. Kept apart from adapter.py, which is over its size cap."""

import re

# Write checks (kept in sync with ChannelsPage.tsx): reject credentials
# pasted into the wrong field. Allowlists split like the adapter's parser (comma, strip, drop
# empties) so a trailing comma the runtime accepts is not refused here.
_BOT_TOKEN_RE = re.compile(r"\d+:[A-Za-z0-9_-]{30,}")
_USER_ID_RE = re.compile(r"\d+")
_ENV_VALUE_RULES = {
    "TELEGRAM_BOT_TOKEN": (
        _BOT_TOKEN_RE.fullmatch,
        "Telegram bot token must be the complete token from @BotFather, such as 123456789:ABC…"),
    "TELEGRAM_ALLOWED_USERS": (
        lambda v: all(_USER_ID_RE.fullmatch(u.strip()) for u in v.split(",") if u.strip()),
        "Telegram allowed users must be comma-separated numeric user IDs."),
}

DASHBOARD_CARD = dict(
    dashboard_description="Run Hermes from Telegram DMs, groups, and topics.",
    docs_url="https://core.telegram.org/bots/features#botfather",
    dashboard_env_vars=("TELEGRAM_BOT_TOKEN", "TELEGRAM_ALLOWED_USERS", "TELEGRAM_PROXY"),
    env_value_rules=_ENV_VALUE_RULES,
)