errors

type ContextProvider interface {
	// Context returns additional context data for logging.
	Context() map[string]any
}

type DomainError struct {
	Code       string `json:"code"`
	Message    string `json:"message"`
	StatusCode int    `json:"-"`
	Details    any    `json:"details,omitempty"`
}

type ErrorBody struct {
	Code    string `json:"code"`
	Message string `json:"message"`
	Details any    `json:"details,omitempty"`
}

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

type ErrorHandlerConfig struct {
	// GlobalContext is a function that returns context data to include in all error logs.
	GlobalContext func(ctx context.Context) map[string]any

	// LogLevelMap allows configuring log levels for specific error types.
	LogLevelMap map[error]slog.Level

	// IgnoredErrors are error types that should not be reported (logged).
	IgnoredErrors []error

	// ThrottleConfig configures throttling of error reporting.
	ThrottleConfig *ThrottleConfig
}

type ErrorResponse struct {
	Error ErrorBody `json:"error"`
}

type LogLevelProvider interface {
	// LogLevel returns the log level for this error.
	LogLevel() slog.Level
}

type Renderable interface {
	// Render returns a custom HTTP response. Return false to fall back to default rendering.
	Render(w http.ResponseWriter, r *http.Request) bool
}

type Reportable interface {
	// Report handles the error reporting. Return false to fall back to default logging.
	Report(ctx context.Context, logger *slog.Logger) bool
}

type ThrottleConfig struct {
	// SampleRate is the fraction of errors to log (0.0 to 1.0).
	// 0.1 means log 10% of errors.
	SampleRate float64

	// RateLimit is the maximum number of errors to log per duration.
	RateLimit int
	Duration  time.Duration

	// KeyFunc determines the throttling key for an error.
	// If nil, uses error type as key.
	KeyFunc func(error) string
}