using System;

namespace GeoVLog.Core.Hdf5;

/// <summary>
/// Options that control **automatic periodic flushing** of the current
/// <c>.h5</c> file to disk.  You may tune *either* of the thresholds,
/// or disable auto-flush completely.  The worker treats the first
/// threshold reached as the flush trigger.
/// </summary>
public sealed class H5LogFlushOptions
{
    /// <summary>
    /// <para>Enable / disable auto-flush.</para>
    /// <para>Default = <see langword="true"/> (recommended: protects data
    /// if the PC loses power while still inflight).</para>
    /// </summary>
    public bool EnableAutoFlush { get; init; } = true;

    /// <summary>
    /// Flush after this many records have been
    /// received since the previous flush.
    /// Set to <c>0</c> to disable the count-based trigger.
    /// </summary>
    public int FlushCount { get; init; } = 0;

    /// <summary>
    /// Flush if this much time has elapsed since the previous flush.
    /// A value of <see cref="TimeSpan.Zero"/> disables the time-based trigger.</summary>
    public TimeSpan FlushInterval { get; init; } = TimeSpan.FromSeconds(60);   // ← 60 s default
}