rework API to use a promise pattern
update examples to promise patter
rework browser example
improve documentation
bump version and tweak description