update readme with promise API examples