events

type Event struct {
	ID               string         `json:"id"`
	EventType        string         `json:"event_type"`
	OccurredAt       time.Time      `json:"occurred_at"`
	ActorID          *string        `json:"actor_id"`
	ActorType        *string        `json:"actor_type"`
	TargetID         *string        `json:"target_id"`
	TargetType       *string        `json:"target_type"`
	TargetIdentifier *string        `json:"target_identifier"`
	TargetSnapshot   map[string]any `json:"target_snapshot,omitempty"`
	Changes          map[string]any `json:"changes,omitempty"`
}

type EventsResponse []Event

type EventsServiceInterface interface {
	// ListEvents returns a list of audit log events
	//
	// Returns audit log events with IDs, event types, timestamps, actor information, and target details.
	// Supports filtering by actor type (user, system, or all) via query options.
	ListEvents(ctx context.Context, opts *RequestQueryOptions) (*EventsResponse, *interfaces.Response, error)

	// ListEventsCSV returns audit log events as CSV
	//
	// Returns audit log event data as CSV with columns: id, event_type, occurred_at, actor_id, actor_type, target_id, target_type, target_identifier.
	// Supports filtering by actor type and optional download parameter via query options.
	ListEventsCSV(ctx context.Context, opts *RequestQueryOptions) ([]byte, *interfaces.Response, error)
}

type RequestQueryOptions struct {
	Filter   string // Filter by actor type: user, system, or all
	Download bool   // For CSV: force download as attachment (set to true to add download=1)
}

type Service struct {
	// contains filtered or unexported fields
}