using Dpz.Core.Public.ViewModel.Request;

namespace Dpz.Core.Service.RepositoryService;

/// <summary>
/// 时间轴
/// </summary>
public interface ITimelineService
{
    /// <summary>
    /// 获取时间轴
    /// </summary>
    /// <param name="account"></param>
    /// <param name="cancellationToken">传播通知操作应取消的通知令牌</param>
    /// <returns></returns>
    Task<List<VmTimeline>> GetTimelinesAsync(
        string account,
        CancellationToken cancellationToken = default
    );

    /// <summary>
    /// 保存时间轴
    /// </summary>
    /// <param name="viewModel"></param>
    /// <param name="cancellationToken">传播通知操作应取消的通知令牌</param>
    /// <returns></returns>
    Task SaveAsync(VmTimeline viewModel, CancellationToken cancellationToken = default);

    /// <summary>
    /// 删除时间轴（支持取消）
    /// </summary>
    /// <param name="id"></param>
    /// <param name="cancellationToken"></param>
    /// <returns></returns>
    Task DeleteAsync(string[] id, CancellationToken cancellationToken = default);

    /// <summary>
    /// 获取时间轴分页信息
    /// </summary>
    /// <param name="request"></param>
    /// <param name="cancellationToken">传播通知操作应取消的通知令牌</param>
    /// <returns></returns>
    Task<IPagedList<VmTimeline>> GetPageAsync(
        TimelinePageRequest request,
        CancellationToken cancellationToken = default
    );

    /// <summary>
    /// 查找时间轴
    /// </summary>
    /// <param name="id"></param>
    /// <param name="cancellationToken">传播通知操作应取消的通知令牌</param>
    /// <returns></returns>
    Task<VmTimeline?> FindAsync(string id, CancellationToken cancellationToken = default);
}