OM-287: comprehensive pre-conditions on public API