breaking change: return a flat object
updated example
documented new result object
release 1.0.0