address review: throttle progress callbacks, fix JSDoc and typing