implement upsert
fix karma tests
use lists on README