jsdoc fix

Correct JSDoc for the public methods, by marking the `options` argument as optional. This solves some IDE (WebStorm in my case) issues where the function call is marked as incomplete.
I was in doubt about this too. So i guess it should be added.