fix: parse bot account profiles

[MikeMike88]

Описание

Боты MAX в ответе get_user присылают gender числовым кодом, а web_app —
строкой-ссылкой вместо объекта. Из-за строгих типов модели User
model_validate падает с ValidationError, и контакт-бот не подтягивается
(воспроизводится на боте «Алиса AI»).

Расширяю типы двух полей:

• gender: str | int | None
• web_app: dict[str, Any] | str | None

Вариант dict у web_app сохранён для обратной совместимости. Обратной
несовместимости нет: у обычных пользователей и у профилей с прежними типами
всё работает как раньше.

Тип изменений

• Исправление бага
• Новая функциональность
• Улучшение документации
• Рефакторинг

Связанные задачи / Issue

Ссылка на issue, если есть: #

Тестирование

Добавлены регрессионные тесты в tests/domain/test_user_models.py:

from pymax.types.domain import User

# Бот: gender числом, web_app строкой-ссылкой — раньше падало с ValidationError
user = User.model_validate({
    "id": 6738397,
    "names": [{"name": "Алиса AI", "type": "NICK"}],
    "gender": 1,
    "webApp": "https://alice.yandex.ru/max_onboarding",
})
assert user.gender == 1
assert user.web_app == "https://alice.yandex.ru/max_onboarding"

Запуск:

pytest tests/domain/test_user_models.py

Summary by CodeRabbit

• Improvements

  • Enhanced API compatibility to handle flexible data formats for user profile information

• Tests

  • Added test coverage for user data parsing with various payload structures

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: a2ae4453-6b09-4943-a606-0952618174ad

📥 Commits

Reviewing files that changed from the base of the PR and between ff3af5b and d1435b6.

📒 Files selected for processing (2)

• src/pymax/types/domain/user.py
• tests/domain/test_user_models.py

---

📝 Walkthrough

Walkthrough

The User domain model's gender field is expanded from str | None to str | int | None, and web_app from dict[str, Any] | None to dict[str, Any] | str | None. Docstrings are updated to match. A new test module covers bot-style, human, and dict web_app payload shapes.

Changes

User Model Field Type Expansion

Layer / File(s)	Summary
User field type annotations expanded src/pymax/types/domain/user.py	Docstring and runtime annotations for gender updated to str | int | None and web_app updated to dict[str, Any] | str | None, with inline comments documenting alternate API payload forms.
Tests for expanded User field types tests/domain/test_user_models.py	New test module asserting bot payloads (numeric gender, URL web_app), minimal human payloads (gender and web_app are None), and backward-compatible dict web_app all parse correctly.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐇 Two fields grew wide, to hold more shapes,
An int, a string — no parsing escapes!
The bot sends a number, a URL in tow,
The human sends nothing, None steals the show.
Our tests hop along and prove it holds true —
More types, more joy, the model breaks through! 🌟

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately describes the main change: extending the User model to handle non-standard bot API payload shapes for gender and web_app fields.
Description check	✅ Passed	The description follows the template structure completely, includes a clear explanation in Russian, specifies the bug fix type, provides concrete test examples, and explains backward compatibility.
Docstring Coverage	✅ Passed	Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[ink-developer]

Спасибо за PR!