chore: configure eslint-jsdoc-plugin

[mateuszlampert]

Description

This PR configures eslint-jsdoc-plugin so:

• JSDocs are consistent throughout codebase and jsdocs are consistent with method/interface signature
• there is defined set of @category tag values to prevent typos and generating additional sections in docs
• fixed few jsdocs manually

Introduces a breaking change?

• Yes
• No

Type of change

• Bug fix (change which fixes an issue)
• New feature (change which adds functionality)
• Documentation update (improves or adds clarity to existing documentation)
• Other (chores, tests, code style improvements etc.)

Tested on

• iOS
• Android

Testing instructions

• try to break some jsdocs (e. g. remove @returns tag, set @category to some value outside of values defined in eslintrc.js, change @param tag so it does not match signature) and see if eslint catches these errors.
• build and open docs locally and check out if api reference is valid

Screenshots

Related issues

#831

Checklist

• I have performed a self-review of my code
• I have commented my code, particularly in hard-to-understand areas
• I have updated the documentation accordingly
• My changes generate no new warnings

Additional notes

NOTE: for now I switched off required destructured params as that's the convention we are mostly using, but we could move to destructured params eventually.