add flatten and map methods to streamline results across provider APIs