"""Minimal WAV helpers (no extra deps) for STT stubs / test audio."""

from __future__ import annotations

import io
import wave


def build_silent_wav(*, duration_ms: int = 400, sample_rate: int = 22050) -> bytes:
    """Return a short silent mono 16-bit WAV (usable as test STT audio)."""
    n_frames = max(1, int(sample_rate * (duration_ms / 1000.0)))
    buf = io.BytesIO()
    with wave.open(buf, "wb") as wf:
        wf.setnchannels(1)
        wf.setsampwidth(2)
        wf.setframerate(sample_rate)
        wf.writeframes(b"\x00\x00" * n_frames)
    return buf.getvalue()


def is_plausible_audio(data: bytes, *, min_bytes: int = 32) -> bool:
    if not data or len(data) < min_bytes:
        return False
    # Reject obvious empty/null payloads
    if data == b"\x00" * len(data):
        return False
    return True
