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