feat: Typescript types

[bflorian]

PR for documentation improvements and typescript support. It introduces typescript types, which can affect the compilation of typescript apps, but generally does not make changes to the JavaScript implementation classes other than removing the old comments that defined types, so that we don't have duplicate type definitions.

It also replaces the old, incomplete manually created markdown docs with new versions generated from the typescript declaration along with a manually created reference index at docs/index.md. The generated document are post-processed to remove implementation details that are not applicable to using the SDK.

• [ ] Bug fix (non-breaking change which fixes an issue)
• [x] New feature (non-breaking change which adds functionality)
• [ ] Breaking change (fix or feature that would cause existing functionality to change)
• [x] I have read the CONTRIBUTING document
• [x] My code follows the code style of this project (hint: install an xo editor plugin)
• [x] Any required documentation has been added
• [ ] I have added tests to cover my changes

[lgtm-com[bot]]

This pull request introduces 1 alert when merging a0ff6c9f0f45ef143926a8cc31da12ddb03aacd4 into 1985ade40166cb65810329be809d9b356cb45a89 - view on LGTM.com

new alerts:

• 1 for Duplicate 'if' condition