expose read flags with convenience methods
update metadata