fix: preserve requested pagination filters and add ReviewsBatch.next_batch

[Flummy1]

Проблема

ReviewsParser и TransactionPreviewsParser читают filter и user_id из
скрытых инпутов ответа:

filter_ = self.tree.css('input[type="hidden"][name="filter"]')
...
filter=filter_[0].attributes.get('value') if filter_ else None,

FunPay отдаёт эти инпуты не во всех ответах users/reviews и
users/transactions — в остальных случаях в батч попадает None. Любая
пагинация, опирающаяся на спарсенное значение, молча теряла запрошенный фильтр:

• TransactionPreviewsBatch.next_batch() подставлял self.filter or '',
  то есть после первой страницы фильтр по типу транзакций сбрасывался на «все»;
• у отзывов пагинации не было вовсе, а нужный для неё user_id терялся так же.

Отдельная деталь: GetReviews в репозитории есть, но он не экспортирован из
funpaybotengine.methods и недоступен через Bot — то есть метод написан,
но пользователю его не достать.

Решение

Парсеры возвращают обычные мутабельные датаклассы, поэтому метод проставляет
запрошенные значения сразу после разбора — рядом с полем, которое перекрывает:

class GetReviews(FunPayMethod[ReviewsBatch]):
    async def parse_result(self, response: RawResponse[Any]) -> ParsedReviewsBatch:
        result: ParsedReviewsBatch = await super().parse_result(response)
        result.user_id = self.user_id
        result.filter = self.filter
        return result

То же самое в GetTransactions.parse_result для filter. Модели при этом не
трогаются вовсе — единственное добавление в них это ReviewsBatch.next_batch(),
аналог того, что уже есть у TransactionPreviewsBatch и OrderPreviewsBatch:

• ValueError('Last batch.'), если next_review_id пуст;
• ValueError('Unknown user id.'), если user_id неизвестен (в отличие от
  транзакций, отзывам нужен явный id профиля — батч со страницы заказа
  пагинировать нечем);
• сохранённый фильтр уходит в следующий запрос.

Чтобы next_batch() было чем выполнять, GetReviews экспортирован из
funpaybotengine.methods и доступен как Bot.get_reviews().

Что изменилось по сравнению с исходной версией PR

Исходная версия переопределяла transform_result и правила поля батча после
построения модели — на 0.10.0rc3 такого хука уже нет, решение переписано под
текущий API.

Сюда же переехал фикс фильтра транзакций из
#40 — он был влит в
ветку #39, но на dev не попал, а баг там ровно тот же.

Использование

batch = await bot.get_reviews(user_id=1234, filter='5')
while True:
    for review in batch.reviews:
        print(review.rating, review.text)
    if not batch.next_review_id:
        break
    batch = await batch.next_batch()   # фильтр '5' сохраняется

Обратная совместимость

Ломающих изменений нет: next_batch() и Bot.get_reviews() — новые, а
предпочтение запрошенного фильтра спарсенному меняет поведение только там, где
раньше значение терялось.

Проверки

uv run ruff check funpaybotengine tests     # чисто (кроме предсуществующего offers.py — см. #39)
uv run mypy funpaybotengine                 # no issues found
uv run pytest tests                         # 21 passed

tests/pagination_filters_test.py фиксирует и предпосылку бага (парсер отдаёт
None, когда скрытых инпутов нет), и то, что parse_result проставляет
запрошенные значения, и то, что фильтр с курсором доезжают до следующего
запроса.

🤖 Generated with Claude Code

[qvvonk]

Передача фильтров через context крайне неявна: будет сложно понять, откуда у модели появились значения, необходимые для пагинации.

Лучше явно устанавливать соответствующие поля в GetReview.parse_result, например:

async def parse_result(self, response: ...) -> ...:
    result = await super().parse_result(response)
    result.filter = ...
    result.user_id = ...
    return result

[Flummy1]

Согласен, поправил — b582777.

Значения теперь проставляются прямо в parse_result, рядом с полем, которое
перекрывают:

class GetReviews(FunPayMethod[ReviewsBatch]):
    async def parse_result(self, response: RawResponse[Any]) -> ParsedReviewsBatch:
        result: ParsedReviewsBatch = await super().parse_result(response)

        # FunPay omits the hidden ``user_id`` / ``filter`` inputs in a part of the
        # ``users/reviews`` responses, so the parsed values are unreliable. The requested
        # ones are known here and are what the next batch has to be asked with.
        result.user_id = self.user_id
        result.filter = self.filter
        return result

То же самое в GetTransactions.parse_result для filter (там уходит
self.filter.value, чтобы не ломать тип поля датакласса — str | None).

Побочный плюс: model_post_init из ReviewsBatch и TransactionPreviewsBatch
ушли совсем, обе модели вернулись к состоянию dev, и единственное добавление
в них — ReviewsBatch.next_batch().

Тесты переписаны под этот путь: теперь они дёргают сам parse_result, а не
проверяют содержимое контекста. ruff / mypy / pytest — зелёные (21 тест).