update utils. remove unused methods. add jsdocs