audit

type Event struct {
	Name       string               `json:"name"`
	Actor      *principal.Principal `json:"actor,omitempty"`
	Action     string               `json:"action"`
	Resource   string               `json:"resource"`
	Result     string               `json:"result"`
	Message    string               `json:"message,omitempty"`
	RequestID  string               `json:"request_id,omitempty"`
	TraceID    string               `json:"trace_id,omitempty"`
	ClientIP   string               `json:"client_ip,omitempty"`
	UserAgent  string               `json:"user_agent,omitempty"`
	Method     string               `json:"method,omitempty"`
	URI        string               `json:"uri,omitempty"`
	Operation  string               `json:"operation,omitempty"`
	StatusCode int                  `json:"status_code,omitempty"`
	Component  string               `json:"component,omitempty"`
	OrgID      string               `json:"org_id,omitempty"`
	ProjectID  string               `json:"project_id,omitempty"`
	StartedAt  time.Time            `json:"started_at"`
	FinishedAt time.Time            `json:"finished_at"`
	Duration   time.Duration        `json:"duration"`
	Metadata   map[string]string    `json:"metadata,omitempty"`
}

type Options struct {
	Component    string
	Resolver     Resolver
	Async        bool
	AsyncLimit   int
	AsyncTimeout time.Duration
}

type Recorder interface {
	Record(ctx context.Context, event Event) error
}

type Resolver func(ctx context.Context, req any, reply any, err error) Event