fix: корректный тип payload для share-вложения (closes #108)

[bish-x]

Что делает PR

Фикс для #108. Входящий attachment с type="share" теперь десериализуется с payload типа ShareAttachmentPayload вместо OtherAttachmentPayload (который по докстрингу «для файлов»), так что пользователь может делать pattern-matching:

match att.payload:
    case ShareAttachmentPayload(): ...      # теперь работает
    case PhotoAttachmentPayload(): ...
    case OtherAttachmentPayload(): ...      # файлы/аудио/видео

Root cause

• Attachments union (maxapi/types/attachments/__init__.py) — discriminated по type, поэтому сам attachment корректно резолвится в Share.
• Share.payload наследовался от базового Attachment, а в его union (attachment.py) не было ShareAttachmentPayload. OtherAttachmentPayload = {url, token | None} — суперсет для payload share-а, pydantic smart-union (2.x) выбирал его первым.

Что меняется

1. Добавлен класс ShareAttachmentPayload с url: str, token: str в maxapi/types/attachments/attachment.py.
2. Share переопределяет payload: ShareAttachmentPayload | None = None. Это ключевая правка — она локализует фикс именно в Share, не затрагивая payload у File / Audio / Video (они продолжают работать через OtherAttachmentPayload).
3. ShareAttachmentPayload также добавлен в базовый Attachment.payload-union после OtherAttachmentPayload — чтобы явная сборка Attachment(type=SHARE, payload=ShareAttachmentPayload(...)) была типобезопасна, без регрессии на File/Audio/Video.
4. ShareAttachmentPayload экспортирован из maxapi.types.

Тесты

• test_share_attachment_payload_deserialize — регрессия Нет типа вложения share -> ошибка определения вложения OtherAttachmentPayload (файл) #108 (share → Share + ShareAttachmentPayload).
• test_file_attachment_payload_unchanged_by_share_fix — страховка, что File по-прежнему получает OtherAttachmentPayload.

Локальный прогон: tests/test_serialization_models.py — все 7 тестов зелёные, полный прогон (кроме test_webhook, где нет опциональных зависимостей, и test_dispatcher, где нет aresponses) — 494 passed.

Нотки

• Совместимо: ничего не ломается для существующих пользователей OtherAttachmentPayload — они у файлов/аудио/видео остаются прежними.
• Сценарий из issue воспроизведён на чистом PyPI maxapi==0.9.18, фикс проверен на ветке.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!