persistence/DD.Persistence.Client/Clients/Interfaces/Refit/IRefitTimestampedValuesClient.cs

using DD.Persistence.Models;
using DD.Persistence.Models.Common;
using Refit;

namespace DD.Persistence.Client.Clients.Interfaces.Refit;

/// <summary>
/// Refit интерфейс для TimestampedValuesController
/// </summary>
public interface IRefitTimestampedValuesClient : IRefitClient, IDisposable
{
    private const string baseUrl = "/api/TimestampedValues";

    /// <summary>
    /// Записать новые данные
    /// </summary>
    [Post($"{baseUrl}/{{discriminatorId}}")]
    Task<IApiResponse<int>> AddRange(Guid discriminatorId, IEnumerable<TimestampedValuesDto> dtos, CancellationToken token);

    /// <summary>
    /// Получение данных с фильтрацией
    /// </summary>
    [Get($"{baseUrl}")]
    Task<IApiResponse<IEnumerable<TimestampedValuesDto>>> Get([Query(CollectionFormat.Multi)] IEnumerable<Guid> discriminatorIds,
        DateTimeOffset? timestampBegin,
        [Query(CollectionFormat.Multi)] IEnumerable<string>? columnNames,
        int skip,
        int take,
        CancellationToken token);

    /// <summary>
    /// Получить данные, начиная с заданной отметки времени
    /// </summary>
    [Get($"{baseUrl}/{{discriminatorId}}/gtdate")]
    Task<IApiResponse<IEnumerable<TimestampedValuesDto>>> GetGtDate(Guid discriminatorId, DateTimeOffset timestampBegin, CancellationToken token);

    /// <summary>
    /// Получить данные c начала
    /// </summary>
    [Get($"{baseUrl}/{{discriminatorId}}/first")]
    Task<IApiResponse<IEnumerable<TimestampedValuesDto>>> GetFirst(Guid discriminatorId, int take, CancellationToken token);

    /// <summary>
    /// Получить данные c конца
    /// </summary>
    [Get($"{baseUrl}/{{discriminatorId}}/last")]
    Task<IApiResponse<IEnumerable<TimestampedValuesDto>>> GetLast(Guid discriminatorId, int take, CancellationToken token);

    /// <summary>
    /// Получить список объектов с прореживанием, удовлетворяющий диапазону временных отметок
    /// </summary>
    [Get($"{baseUrl}/{{discriminatorId}}/resampled")]
    Task<IApiResponse<IEnumerable<TimestampedValuesDto>>> GetResampledData(Guid discriminatorId, DateTimeOffset timestampBegin, double intervalSec = 600d, int approxPointsCount = 1024, CancellationToken token = default);

    /// <summary>
    /// Получить количество записей по указанному набору в БД. Для пагинации
    /// </summary>
    [Get($"{baseUrl}/{{discriminatorId}}/count")]
    Task<IApiResponse<int>> Count(Guid discriminatorId, CancellationToken token);

    /// <summary>
    /// Получить диапазон дат, в пределах которых хранятся даные
    /// </summary>
    [Get($"{baseUrl}/{{discriminatorId}}/datesRange")]
    Task<IApiResponse<DatesRangeDto?>> GetDatesRange(Guid discriminatorId, CancellationToken token);
}