Import AITURK IDE 1.0.0-beta.1 from Hermes 63279301; preserve MIT license

tests/gateway/test_telegram_username_chat_id.py

@@ -0,0 +1,160 @@
+"""Tests for Telegram username (non-numeric) chat_id handling (#13206).
+
+When ``TELEGRAM_HOME_CHANNEL`` is an ``@username`` rather than a numeric chat
+ID, webhook/cron deliveries that fall back to the home channel used to crash
+with ``ValueError: invalid literal for int()`` because the adapter coerced
+every chat_id with ``int()``. Telegram's Bot API accepts both forms, so the
+adapter now normalizes instead of force-casting.
+"""
+
+import sys
+import types
+from types import SimpleNamespace
+
+import pytest
+
+from gateway.config import PlatformConfig, Platform
+from plugins.platforms.telegram.telegram_ids import (
+    looks_like_telegram_username,
+    normalize_telegram_chat_id,
+    parse_telegram_username_target,
+    telegram_chat_id_key,
+)
+
+
+# ---------------------------------------------------------------------------
+# Helper-level behavior (no telegram import needed)
+# ---------------------------------------------------------------------------
+
+@pytest.mark.parametrize(
+    "value,expected",
+    [
+        ("123456789", 123456789),             # positive numeric DM id
+        ("-1001234567890", -1001234567890),   # negative channel/supergroup id
+        (123456789, 123456789),               # already int
+        ("  42 ", 42),                        # surrounding whitespace
+        ("@some_user", "@some_user"),         # username passes through as str
+        ("@a_channel", "@a_channel"),
+        ("not_numeric", "not_numeric"),       # any other non-numeric string
+    ],
+)
+def test_normalize_returns_int_or_passthrough_string(value, expected):
+    assert normalize_telegram_chat_id(value) == expected
+
+
+def test_numeric_normalizes_to_int_type():
+    assert isinstance(normalize_telegram_chat_id("123"), int)
+
+
+# ---------------------------------------------------------------------------
+# Fake telegram module tree (mirrors test_telegram_thread_fallback.py)
+# ---------------------------------------------------------------------------
+
+class FakeNetworkError(Exception):
+    pass
+
+
+class FakeBadRequest(FakeNetworkError):
+    pass
+
+
+class FakeTimedOut(FakeNetworkError):
+    pass
+
+
+class _FakeInlineKeyboardButton:
+    def __init__(self, text, callback_data=None, **kwargs):
+        self.text = text
+        self.callback_data = callback_data
+
+
+class _FakeInlineKeyboardMarkup:
+    def __init__(self, inline_keyboard):
+        self.inline_keyboard = inline_keyboard
+
+
+_fake_telegram = types.ModuleType("telegram")
+_fake_telegram.Update = object
+_fake_telegram.Bot = object
+_fake_telegram.Message = object
+_fake_telegram.InlineKeyboardButton = _FakeInlineKeyboardButton
+_fake_telegram.InlineKeyboardMarkup = _FakeInlineKeyboardMarkup
+_fake_telegram.InputMediaPhoto = object
+_fake_telegram_error = types.ModuleType("telegram.error")
+_fake_telegram_error.NetworkError = FakeNetworkError
+_fake_telegram_error.BadRequest = FakeBadRequest
+_fake_telegram_error.TimedOut = FakeTimedOut
+_fake_telegram.error = _fake_telegram_error
+_fake_telegram_constants = types.ModuleType("telegram.constants")
+_fake_telegram_constants.ParseMode = SimpleNamespace(
+    MARKDOWN_V2="MarkdownV2", MARKDOWN="Markdown", HTML="HTML",
+)
+_fake_telegram_constants.ChatType = SimpleNamespace(
+    GROUP="group", SUPERGROUP="supergroup", CHANNEL="channel", PRIVATE="private",
+)
+_fake_telegram.constants = _fake_telegram_constants
+_fake_telegram_ext = types.ModuleType("telegram.ext")
+for _attr in (
+    "Application", "CommandHandler", "CallbackQueryHandler", "InlineQueryHandler",
+    "MessageHandler", "TypeHandler",
+):
+    setattr(_fake_telegram_ext, _attr, object)
+_fake_telegram_ext.ContextTypes = SimpleNamespace(DEFAULT_TYPE=object)
+_fake_telegram_ext.filters = object
+_fake_telegram_request = types.ModuleType("telegram.request")
+_fake_telegram_request.HTTPXRequest = object
+
+
+@pytest.fixture(autouse=True)
+def _inject_fake_telegram(monkeypatch):
+    monkeypatch.setitem(sys.modules, "telegram", _fake_telegram)
+    monkeypatch.setitem(sys.modules, "telegram.error", _fake_telegram_error)
+    monkeypatch.setitem(sys.modules, "telegram.constants", _fake_telegram_constants)
+    monkeypatch.setitem(sys.modules, "telegram.ext", _fake_telegram_ext)
+    monkeypatch.setitem(sys.modules, "telegram.request", _fake_telegram_request)
+
+
+def _make_adapter():
+    from plugins.platforms.telegram.adapter import TelegramAdapter
+
+    config = PlatformConfig(enabled=True, token="fake-token")
+    adapter = object.__new__(TelegramAdapter)
+    adapter.config = config
+    adapter._config = config
+    adapter._platform = Platform.TELEGRAM
+    adapter._connected = True
+    adapter._dm_topics = {}
+    adapter._dm_topics_config = []
+    adapter._reply_to_mode = "first"
+    adapter._fallback_ips = []
+    adapter._polling_conflict_count = 0
+    adapter._polling_network_error_count = 0
+    adapter._polling_error_callback_ref = None
+    adapter.platform = Platform.TELEGRAM
+    return adapter
+
+
+# ---------------------------------------------------------------------------
+# Adapter send path: username chat_id reaches the Bot API without int() crash
+# ---------------------------------------------------------------------------
+
+@pytest.mark.asyncio
+async def test_send_passes_username_chat_id_through_unchanged():
+    """adapter.send(@username) calls the Bot API with the username string
+    rather than crashing on int() coercion (the #13206 regression)."""
+    adapter = _make_adapter()
+    call_log = []
+
+    async def mock_send_message(**kwargs):
+        call_log.append(dict(kwargs))
+        return SimpleNamespace(message_id=99)
+
+    adapter._bot = SimpleNamespace(send_message=mock_send_message)
+
+    result = await adapter.send(chat_id="@some_user", content="hello world")
+
+    assert result.success is True
+    assert call_log, "send_message was never called"
+    assert call_log[0]["chat_id"] == "@some_user"
+
+