Documentation and Tests: Petition plugin API

[vincemtnz]

Complete the Petition Plugin API to include

• [] Events emitted and their payloads
• [] Tests for events.
• [] Complete documentation of lifecycle hooks (and add missing ones?): petition:complete:before and petition:[ref]:complete:before). Add example implemen
• [] Tests for lifecycle hooks.