Events

All events are final readonly and dispatched after the surrounding transaction commits (ShouldDispatchAfterCommit). Unless noted, each carries $audit — an ImportAudit with sessionId, batchId, importer, owner, the actor of that operation (uploader, committer or the user who undid it), the file (a FileReference: disk, path, originalName, size, sha256, format), counts and at.

Listeners of a batch’s ImportCompleted and ImportFailed run inside the owner’s context. A session whose owner was deleted is still closed by housekeeping — failed, its undo finished or expired, its lock released — but fires no event, because the audit names the owner.

use Illuminate\Support\Facades\Event;
use RoundlyConsulting\Imports\Events\ImportCompleted;

Event::listen(function (ImportCompleted $event): void {
    $event->audit->actor?->notify(new ImportFinished(
        importer: $event->audit->importer,
        file: $event->audit->file->originalName,
        created: $event->summary->created,
        failed: $event->summary->failed,
    ));
});