Kavita/Kavita.API/Services/IRatingService.cs

using System.Threading;
using System.Threading.Tasks;
using Kavita.Models.DTOs;
using Kavita.Models.Entities.User;

namespace Kavita.API.Services;

public interface IRatingService
{
    /// <summary>
    /// Updates the users' rating for a given series
    /// </summary>
    /// <param name="user">Should include ratings</param>
    /// <param name="updateRatingDto"></param>
    /// <param name="ct"></param>
    /// <returns></returns>
    Task<bool> UpdateSeriesRating(AppUser user, UpdateRatingDto updateRatingDto, CancellationToken ct = default);

    /// <summary>
    /// Updates the users' rating for a given chapter
    /// </summary>
    /// <param name="user">Should include ratings</param>
    /// <param name="updateRatingDto">chapterId must be set</param>
    /// <param name="ct"></param>
    /// <returns></returns>
    Task<bool> UpdateChapterRating(AppUser user, UpdateRatingDto updateRatingDto, CancellationToken ct = default);
}