Events Reference

Chronicle dispatches two Laravel events from Chronicle\Events\.

EntryRecorded

Chronicle\Events\EntryRecorded

Fired after a Chronicle entry has been successfully persisted.

Payload

public readonly Entry $entry

The fully persisted Chronicle\Entry\Entry model.

When it fires

EntryRecorded is dispatched by the PersistEntry pipeline stage, which runs at the end of the synchronous write path.

Important: when driver = 'queued', Chronicle dispatches a PersistChronicleEntryJob instead of running the full pipeline. The job calls ChainHashEntry and DatabaseDriver directly — it does not pass through PersistEntry. As a result, EntryRecorded is not fired when using the queued driver.

Listening

use Chronicle\Events\EntryRecorded;

// In EventServiceProvider
protected $listen = [
    EntryRecorded::class => [
        App\Listeners\NotifyAuditWebhook::class,
    ],
];

// Or inline with a closure
Event::listen(EntryRecorded::class, function (EntryRecorded $event) {
    Log::info('Entry recorded', ['action' => $event->entry->action]);
});

---

EntryRejected

Chronicle\Events\EntryRejected

Fired when a Chronicle entry is rejected by a validator or policy extension before persisting.

Payload

public readonly Throwable $reason
public readonly array     $payload

Property	Type	Description
$reason	Throwable	The exception that caused the rejection
$payload	array	The raw entry attributes at the point of rejection

When it fires

EntryRejected is dispatched by ChronicleManager when commit() is called and an extension (validator or policy) throws an exception. The entry is never persisted when this event fires.

Listening

use Chronicle\Events\EntryRejected;

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

Example listener:

class LogRejectedEntry
{
    public function handle(EntryRejected $event): void
    {
        Log::warning('Chronicle entry rejected', [
            'reason'  => $event->reason->getMessage(),
            'action'  => $event->payload['action'] ?? null,
            'actor'   => $event->payload['actor_type'] ?? null,
        ]);
    }
}

See also

• Storage Drivers — queued driver behaviour and EntryRecorded timing
• Validation — built-in validators that trigger EntryRejected
• Policies — built-in policies that trigger EntryRejected