Add comments to the typescript definitions [enhancement]

[IrvingArmenta]

I think it would be nice to add comments to the typescript definitions, using the same documentation as is in this repository. I already did it on local but I don't have the permissions for PR's of course.

This is for the usage with VScode, following the TS doc format:

[diegohaz]

Hi @IrvingArmenta! Could you please send a PR?