Events

Writes and deletes dispatch events you can listen to for audit trails and integrations:

use Illuminate\Support\Facades\Event;
use RoundlyConsulting\Options\Events\OptionForgotten;
use RoundlyConsulting\Options\Events\OptionSet;

Event::listen(OptionSet::class, function (OptionSet $event): void {
    logger()->info('Option changed', [
        'key' => $event->key,
        'owner' => $event->owner?->getKey(),
    ]);
});

Event::listen(OptionForgotten::class, function (OptionForgotten $event): void {
    // $event->key, $event->owner
});

Switches

OPTIONS_EVENTS_ENABLED=true    # OptionSet + OptionForgotten (observers run either way)
OPTIONS_EVENTS_RESOLVED=true   # also OptionResolved on every read

• All three events need options.events.enabled (on by default). OptionResolved also needs options.events.resolved — it fires on every read, so it’s off by default.
• OptionSet and OptionResolved carry the cast value — the same value get() returns. For encrypted options that’s the plain value — keep it out of logs.
• OptionSet and OptionForgotten fire once the write is durable: at once outside a transaction, after the outermost commit inside one (DB::transaction(), setMany(), a group set()), and never for a write that rolls back.
• Events are dispatched synchronously; queue your listener if the work is slow.
• Turning events off silences only the events: the write calls observers and live config overrides itself, so they still run.