Document global types and API wrappers

[pearj]

The API wrappers and global types would benefit from documentation, as it would be helpful when IDE's are doing type-ahead assistance.

We should be able to grab the documentation in the integrators guide and add it to the relevant functions.

https://backstage.forgerock.com/docs/idm/6.5/integrators-guide/#appendix-scripting

[pearj]

This is largely resolved. There is a bit more left on the api docs internally.