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/{discriminatorId}";

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

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

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

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

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

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

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

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