Skip to main content

Listening to Events

Chronicle dispatches two Laravel events you can listen to: EntryRecorded (after a successful persist) and EntryRejected (when a validator or policy blocks an entry).

Registering listeners​

In EventServiceProvider​

use Chronicle\Events\EntryRecorded;
use Chronicle\Events\EntryRejected;

protected $listen = [
    EntryRecorded::class => [
        App\Listeners\ForwardToAuditWebhook::class,
        App\Listeners\InvalidateAuditCache::class,
    ],
    EntryRejected::class => [
        App\Listeners\LogRejectedEntry::class,
    ],
];

Via Event::listen()​

use Chronicle\Events\EntryRecorded;
use Chronicle\Events\EntryRejected;
use Illuminate\Support\Facades\Event;

Event::listen(EntryRecorded::class, function (EntryRecorded $event) {
    // $event->entry is the persisted Entry model
    cache()->forget('audit:latest');
});

Event::listen(EntryRejected::class, function (EntryRejected $event) {
    // $event->reason  — the exception that caused the rejection
    // $event->payload — raw entry attributes at rejection time
    logger()->warning('Chronicle entry rejected', [
        'reason' => $event->reason->getMessage(),
        'action' => $event->payload['action'] ?? null,
    ]);
});

Important: queued driver timing​

EntryRecorded is dispatched by the synchronous PersistEntry pipeline stage. When driver = 'queued', that stage is bypassed — EntryRecorded is not fired. See Events Reference for the full explanation.

Full event documentation​

For payload details, property types, and more examples see the Events Reference.

See also​