Elaborated on use cases and added note that the API should be rewritten ...

...to use promises.