"""Атомарная отправка сообщения с защитой от повторов.""" import hashlib import json import re from uuid import UUID from sqlalchemy.ext.asyncio import AsyncSession from app.domain.chats import ensure_chat_member from app.domain.attachments import validate_message_attachments from app.errors.exceptions import conflict, invalid_request, unavailable from app.schemas.message import CreateMessage, Message from app.schemas.user import User from app.storage import idempotency as key_storage from app.storage import messages as message_storage from app.storage import attachments as attachment_storage IDEMPOTENCY_KEY_PATTERN = re.compile(r"[A-Za-z0-9._:-]{1,128}") def validate_idempotency_key(key: str | None) -> str: """Проверяет обязательный ASCII-ключ запроса.""" if key is None or IDEMPOTENCY_KEY_PATTERN.fullmatch(key) is None: raise invalid_request("Требуется корректный Idempotency-Key") return key def request_fingerprint(new_message: CreateMessage) -> str: """Хеширует нормализованное содержимое запроса.""" body = new_message.model_dump(mode="json") # Сохраняет прежние отпечатки текстовых запросов и равенство absent / []. if not body["attachment_ids"]: body.pop("attachment_ids") canonical = json.dumps(body, sort_keys=True, ensure_ascii=False) return hashlib.sha256(canonical.encode()).hexdigest() async def send_message_idempotent( session: AsyncSession, sender: User, chat_id: UUID, new_message: CreateMessage, idempotency_key: str, max_messages: int, ttl_seconds: int, ) -> Message: """Создаёт сообщение или возвращает результат прежнего запроса.""" await ensure_chat_member(session, sender, chat_id) scope = (sender.id, "POST", f"/api/v1/chats/{chat_id}/messages", idempotency_key) fingerprint = request_fingerprint(new_message) await key_storage.lock_key(session, scope) previous = await key_storage.get_active_key(session, scope, ttl_seconds) if previous is not None: if previous.request_hash != fingerprint: raise conflict("Idempotency-Key уже использован для другого сообщения") message = await message_storage.get_message(session, previous.message_id) else: await validate_message_attachments( session, sender, chat_id, new_message.attachment_ids ) if not await message_storage.reserve_message_slot(session, max_messages): raise unavailable("Достигнут лимит количества сообщений") message = await message_storage.create_message( session, chat_id=chat_id, sender_id=sender.id, text=new_message.text ) await attachment_storage.bind_attachments( session, message.id, new_message.attachment_ids ) await key_storage.save_result(session, scope, fingerprint, message.id) links = await attachment_storage.message_attachment_ids(session, [message.id]) result = Message.model_validate(message).model_copy( update={"attachment_ids": links[message.id]} ) await session.commit() return result