namespace GermanApp.Domain.Interfaces;

/// <summary>
/// Domain interface for Vosk speech recognition service.
/// This is part of the Domain layer.
/// </summary>
public interface IVoskService
{
    /// <summary>
    /// Recognizes speech from audio bytes.
    /// </summary>
    /// <param name="audioBytes">Audio data in bytes (WAV format)</param>
    /// <param name="sampleRate">Sample rate of the audio in Hz</param>
    /// <param name="hint">Optional hint/phrase to improve recognition accuracy</param>
    /// <param name="cancellationToken">Cancellation token</param>
    /// <returns>Recognized text</returns>
    Task<string> RecognizeSpeechAsync(
        byte[] audioBytes,
        int sampleRate = 16000,
        string? hint = null,
        CancellationToken cancellationToken = default);

    /// <summary>
    /// Recognizes speech from an audio file path.
    /// </summary>
    /// <param name="audioFilePath">Path to the audio file</param>
    /// <param name="cancellationToken">Cancellation token</param>
    /// <returns>Recognized text</returns>
    Task<string> RecognizeSpeechFromFileAsync(
        string audioFilePath,
        CancellationToken cancellationToken = default);

    /// <summary>
    /// Recognizes speech from a stream.
    /// </summary>
    /// <param name="audioStream">Audio stream</param>
    /// <param name="sampleRate">Sample rate of the audio in Hz</param>
    /// <param name="cancellationToken">Cancellation token</param>
    /// <returns>Recognized text</returns>
    Task<string> RecognizeSpeechFromStreamAsync(
        System.IO.Stream audioStream,
        int sampleRate = 16000,
        CancellationToken cancellationToken = default);

    /// <summary>
    /// Tests the Vosk model and configuration.
    /// </summary>
    /// <param name="cancellationToken">Cancellation token</param>
    /// <returns>True if model is loaded and working</returns>
    Task<bool> TestModelAsync(CancellationToken cancellationToken = default);

    /// <summary>
    /// Gets the current Vosk model information.
    /// </summary>
    /// <returns>Model name and path</returns>
    Task<(string ModelName, string ModelPath)> GetModelInfoAsync();
}