Update README to document the `data` and `res` return values.

I also made a second commit to update the History and package.json files
so that this change is release-ready if accepted.

Thanks.