How to correctly define types for onInsert handlers?

[rafaeldcf]

I want to define the types for onInsert handlers. The data I insert has a different Types from the data I get in queries.

[KyleAMathews]

I put up a PR that among other things documents this: #741