@spec auditable?(operation(), [map()], keyword()) :: boolean()

Returns whether a completed operation has anything to audit.

An update whose tracked field changes are empty records nothing. That covers a changeset with no changes at all, and an update touching only fields the schema policy excluded with only or except — by the application's own declaration, nothing auditable happened.

A caller who supplied :data or :type is recording a semantic fact rather than a diff, so the event is kept. Inserts and deletes are always audited: creating or destroying the row is the fact, independent of which fields are tracked.

@spec changes(operation(), Ecto.Changeset.t(), struct(), keyword()) :: [map()]

Returns normalized field transitions for a changeset.

Only fields present in changeset.changes are included. Database-generated fields are therefore not misrepresented as user changes.

@spec event(operation(), Ecto.Changeset.t(), struct(), keyword()) ::
  Chronicle.Event.t()

Builds an event for a completed Ecto operation.

result is the inserted, updated, or deleted schema returned by the repo. Configure :redact with field atoms/strings or a (field, value -> value) function. Common credential fields are redacted by default.