fix(docs): repair generated API documentation so that links between packages are rendered

[sranka]

Fixes #566

Proposed Changes

• reference identifiers in api-extractor output are validated against existing identifiers, fix-extracted-api-files.js was modified
• references to unknown identifiers are fixed automatically, if possible
  • usually a replacement of !~ to simple ! is sufficient to make things work, for example FIXED @influxdata/influxdb-client!~WriteRetryOptions:interface => @influxdata/influxdb-client!WriteRetryOptions:interface
  • there is also a map that fixes a few namings errors produced by api-extractor and a list of id prefixes that are ignored (with a documented explanation)
  • all the fixes are printed to console
• failure to resolve a documentation reference is reported with 1 exit code
  • all errors are printed together before the process exits
  • yarn apidoc:ci will fail and therefore CI checks will fail on invalid references

Moreover, this PR also upgrades api-extractor and api-documenter to latest version. Some of the issues get resolved with the upgrade.

Checklist

• CHANGELOG.md updated
• Rebased/mergeable
• A test has been added if appropriate
• yarn test completes successfully
• Commit messages are conventional

[codecov-commenter]

Codecov Report

Merging #567 (1a144ff) into master (d5a5382) will not change coverage.
The diff coverage is n/a.

@@            Coverage Diff            @@
##            master      #567   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           33        33           
  Lines         1273      1273           
  Branches       306       306           
=========================================
  Hits          1273      1273           

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

[bednar]

Tested generated docs by yarn apidoc... it looks good 👍

LGTM 🍻