feat(services): add pass-through methods for new features

CaptchaService: has_been_welcomed, mark_welcomed, get_welcome_delay,
set_welcome_delay. ModerationService: upsert_known_user,
get_known_user_by_username.

Author: 0xMett

src/python_italy_bot/services/captcha.py

@@ -3,7 +3,13 @@
 import re
 from pathlib import Path
 
-from telegram import Chat, ChatPermissions, InlineKeyboardButton, InlineKeyboardMarkup, User
+from telegram import (
+    Chat,
+    ChatPermissions,
+    InlineKeyboardButton,
+    InlineKeyboardMarkup,
+    User,
+)
 
 from .. import strings
 from ..db.base import AsyncRepository
@@ -49,7 +55,7 @@ def format_welcome_message(
 
     def parse_button_urls(self, text: str) -> tuple[str, InlineKeyboardMarkup | None]:
         """Extract buttonurl:// patterns and build InlineKeyboardMarkup.
-        
+
         Returns (clean_text, keyboard) where clean_text has button syntax removed.
         Multiple buttons on the same line become the same row.
         """
@@ -160,3 +166,23 @@ async def add_pending(self, user_id: int, chat_id: int) -> None:
     async def is_globally_verified(self, user_id: int) -> bool:
         """Check if user is globally verified."""
         return await self._repo.is_globally_verified(user_id)
+
+    # -- Welcome-once-per-group --
+
+    async def has_been_welcomed(self, user_id: int, chat_id: int) -> bool:
+        """Check if user has already been welcomed in this chat."""
+        return await self._repo.has_been_welcomed(user_id, chat_id)
+
+    async def mark_welcomed(self, user_id: int, chat_id: int) -> None:
+        """Mark user as having been welcomed in this chat."""
+        await self._repo.mark_welcomed(user_id, chat_id)
+
+    # -- Welcome delay --
+
+    async def get_welcome_delay(self, chat_id: int) -> int | None:
+        """Get welcome message auto-delete delay in minutes for a chat."""
+        return await self._repo.get_welcome_delay(chat_id)
+
+    async def set_welcome_delay(self, chat_id: int, minutes: int | None) -> None:
+        """Set welcome message auto-delete delay. None to reset to default."""
+        await self._repo.set_welcome_delay(chat_id, minutes)

src/python_italy_bot/services/moderation.py

@@ -3,6 +3,7 @@
 from telegram import ChatPermissions
 
 from ..db.base import AsyncRepository
+from ..db.models import KnownUser
 
 
 class ModerationService:
@@ -105,3 +106,19 @@ async def add_report(
             message_id=message_id,
             reason=reason,
         )
+
+    # -- Known users (user tracking) --
+
+    async def upsert_known_user(
+        self,
+        user_id: int,
+        username: str | None,
+        first_name: str | None,
+        last_name: str | None,
+    ) -> None:
+        """Insert or update a known user's info."""
+        await self._repo.upsert_known_user(user_id, username, first_name, last_name)
+
+    async def get_known_user_by_username(self, username: str) -> KnownUser | None:
+        """Get a known user by username (case-insensitive)."""
+        return await self._repo.get_known_user_by_username(username)