brought API list up to speed
added some type comments
'cleaning up' tests - for a given definition of cleaner