#pragma once
// ov-error.h: internal helpers backing the public ov_last_error() entry
// and the ov_log_set callback routing.
//
// Not part of the public ABI. Translation units that emit user-facing
// errors include this header to record a diagnostic on the calling thread
// before they return a negative ov_status (or NULL). The actual storage
// and the public ov_last_error() reader live in omnivoice.cpp.
//
// Storage is thread_local so concurrent ov_synthesize calls on different
// threads never race on each other's messages. The setter is variadic with
// printf semantics; messages longer than the internal buffer are
// truncated, never split. Passing NULL as fmt clears the slot.
//
// ov_throw is the load-path counterpart: functions deep inside the GGUF
// reader and the audio tokenizer load chain cannot return false up 97 call
// sites without a massive cascade. They throw a std::runtime_error instead,
// which the ABI boundary entries (ov_init, ov_synthesize) catch and
// convert into ov_set_error + a negative ov_status. Exceptions never
// cross the extern "C" boundary, so the public API stays pure C.
//
// ov_log routes a formatted message to the user-installed ov_log_cb, or
// to stderr when no callback is installed. Used by every translation unit
// in the lib that wants its diagnostics to be redirectable from a wrapper
// (Python logging, Rust tracing, ...). The level enum lives in omnivoice.h.

#include "omnivoice.h"

#include <cstdarg>

void ov_set_error(const char * fmt, ...)
#if defined(__GNUC__) || defined(__clang__)
    __attribute__((format(printf, 1, 2)))
#endif
    ;

void ov_set_error_v(const char * fmt, va_list ap);

// Throws std::runtime_error formatted with printf semantics. Tagged
// noreturn so the compiler can prune unreachable branches at the call
// site. Designed for the GGUF / codec load path where any failure means
// the model is unusable and unwinding to the ABI boundary is the only
// sane recovery.
[[noreturn]] void ov_throw(const char * fmt, ...)
#if defined(__GNUC__) || defined(__clang__)
    __attribute__((format(printf, 1, 2)))
#endif
    ;

// Routes a formatted message at the requested level to the installed
// ov_log_cb. Defaults to stderr (with a trailing newline) when no
// callback is set, so existing fprintf-style call sites can migrate
// one at a time without changing user-visible behaviour. printf
// semantics; messages longer than the internal buffer are truncated.
void ov_log(enum ov_log_level level, const char * fmt, ...)
#if defined(__GNUC__) || defined(__clang__)
    __attribute__((format(printf, 2, 3)))
#endif
    ;