fix: ensure docs include @returns Promise<void> where appropriate

fix: ensure docs include @returns Promise<void> where appropriate #3132