namespace GB5Shared.Telemetry.Observability;

/// <summary>
/// Fire-and-forget sink for <see cref="ObservabilityRecord"/> entries.
/// <para>
/// Implementations MUST be non-blocking — callers (middleware, job wrappers)
/// never await. The bounded <see cref="System.Threading.Channels.Channel{T}"/>
/// inside <see cref="ObservabilityWriter"/> drops the oldest entry when full
/// rather than applying back-pressure to the request path.
/// </para>
/// </summary>
public interface IObservabilityWriter
{
    /// <summary>
    /// Enqueue a record for asynchronous bulk-insert to TOBSERVABILITY.
    /// Never throws — silently drops when the channel is full.
    /// </summary>
    void Enqueue(ObservabilityRecord record);
}