Core API code for promopuffin implementations