as previously discussed, I'd prefer this to be a formal part (read public) part of the api.  That said, I know this opinion isn't universally held, so fine with being package protected.