refactor(zone): add return types & doc