[add] new methods to public API