feedBack-desktop/src/audio/InputRingReader.h

#pragma once
#include <cstdint>
#include <vector>

// InputRingReader — the narrow slice of a capture chain that NoteVerifier needs:
// the post-input lock-free sample ring plus the device sample rate. Factored out
// of AudioEngine so the verifier reads ITS OWN source's ring rather than the
// engine's single global one — the precondition for N independent capture chains
// (a SourceChain per audio input). AudioEngine used to expose these directly and
// NoteVerifier held an `AudioEngine&`; now SourceChain implements this interface
// and owns one verifier. See SourceChain.h.
class InputRingReader
{
public:
    virtual ~InputRingReader() = default;

    // Most-recent N samples from the pre-gate input ring, zero-padded on the
    // left during cold start so the newest sample lands at out.back(). Off-
    // audio-thread safe (acquire-loads the ring write index).
    virtual std::vector<float> getInputFrame(int numSamples) const = 0;

    // Gapless consumption: copies every sample written since monotonic index
    // `fromIndex` into `out` and returns the current write index. See
    // AudioEngine::getInputSince (the original) for the full contract.
    virtual uint64_t getInputSince(uint64_t fromIndex, std::vector<float>& out) const = 0;

    // The live device sample rate the ring samples were captured at.
    virtual double getCurrentSampleRate() const = 0;
};