provide better documentation for draftProvider typings

[lukesmurray]

The current draftProvider typings require that the draft allow for undefined. We should explore whether this is necessary. If it is we should document why and if it isn't we should change the types to be more flexible.