add note to refactor the typescript definitions