Idiomatic implementations of API

[gkellogg]

The API is described using WebIDL to provide a formalized way of talking about parameters and calling sequences. This includes the use of promises and options.

Although there are a number of implementations of Promises outside of JavaScript, it is not intended that implementations strictly adhere to this and should stick to the normal language idioms for asynchronous or block calling conventions, as appropriate.