voxeraLog function

void voxeraLog(
  1. String message()
)

Debug-only logging for the kit's hot paths.

debugPrint is not stripped from release builds: it formats its argument and writes to the platform log every time it is called. On paths that run per participant, per seat or per event that is real work in production — and it leaks the kit's internals into the customer's logs.

Taking the message as a closure means the string is never even built unless kDebugMode is true, so an interpolation like 'seat ${seat.index} → $x' costs nothing in release. The whole call is compiled away.

Use for diagnostics. Anything a customer must see in production belongs in a real error path, not here.

Implementation

void voxeraLog(String Function() message) {
  if (kDebugMode) debugPrint(message());
}