using AVEVA.Historian.Client.Models;

namespace AVEVA.Historian.Client.StoreForward;

/// <summary>
/// The actual delivery target the forwarder replays buffered writes through. Abstracted from
/// <see cref="HistorianClient"/> so the store-forward logic can be unit-tested without a server, and
/// so callers can plug a custom delivery path.
/// <para>
/// Contract: return <c>true</c> when the historian accepted the write; return <c>false</c> or throw
/// when it did not. The forwarder treats both a <c>false</c> return and a thrown exception as "not
/// delivered" and keeps the entry buffered for retry — so a transient disconnect (which throws) and
/// a soft rejection (which returns false) are both safe.
/// </para>
/// </summary>
public interface IHistorianWriteSink
{
    /// <summary>Delivers a batch of historical values for <paramref name="tag"/>.</summary>
    Task<bool> SendHistoricalValuesAsync(string tag, IReadOnlyList<HistorianHistoricalValue> values, CancellationToken cancellationToken);

    /// <summary>Delivers a single event.</summary>
    Task<bool> SendEventAsync(HistorianEvent historianEvent, CancellationToken cancellationToken);
}