BTW I'd also be okay updating this API in a later pull request before we release 1.0. It's fair game to change new APIs in that time window.