[#75384126] use annotations and exceptions to reduce code noise