update that adds .add, .addOptions & .replaceOptions public methods