Events

Each write dispatches an event so your app can react — send a verification email, sync a CRM, update a search index — without forking the package:

use Illuminate\Support\Facades\Event;
use RoundlyConsulting\Contacts\Events\ContactAdded;
use RoundlyConsulting\Contacts\Events\PrimaryContactChanged;

Event::listen(function (ContactAdded $event): void {
    // $event->contact — push to your CRM, search index or audit log
});

Event::listen(function (PrimaryContactChanged $event): void {
    // $event->contact is the new primary, $event->previous the demoted one (or null)
});

Adding a contact that becomes primary fires ContactAdded first, then PrimaryContactChanged. Deleting, syncing away or moving the primary fires PrimaryContactChanged for the contact promoted in its place. Events fire only through the action, facade and trait path — raw contacts()->create() calls stay silent.