Agreed, this API was weird and definitely a foot-gun.