namespace DeepDrftAPI.Services.Opus;

/// <summary>
/// The enqueue seam for the background Opus transcode (OQ6 / §3.1a). <see cref="UnifiedTrackService"/>
/// depends only on this thin interface — not on the worker — so adding the background derive to the
/// upload/replace paths costs one small dependency, not the whole transcode graph. Enqueuing is
/// non-blocking and best-effort: a freshly uploaded track is already persisted and playable losslessly
/// before anything is enqueued, and the transcode runs off the request thread.
/// </summary>
public interface IOpusTranscodeQueue
{
    /// <summary>
    /// Schedules a background Opus derive for the track identified by <paramref name="entryKey"/>. Returns
    /// immediately. A dropped or failed enqueue must not affect the caller — the track remains
    /// lossless-only and eligible for backfill.
    /// </summary>
    void Enqueue(string entryKey);
}