[Fix] add a few jsdoc type annotations to work around TS inference bugs for consumers

[Fix] add a few jsdoc type annotations to work around TS inference bugs for consumers #1966