errors

type APIResponse[T any] struct {
	Type      ResponseType `json:"type"`
	Success   bool         `json:"success"`
	Data      T            `json:"data,omitempty"`
	Error     *ErrorInfo   `json:"error,omitempty"`
	Metadata  *Metadata    `json:"metadata,omitempty"`
	Timestamp time.Time    `json:"timestamp"`
	RequestID string       `json:"request_id"`
}

type AppError struct {
	// 基本错误信息
	Code      ErrorCode     `json:"code"`
	Message   string        `json:"message"`
	Details   string        `json:"details,omitempty"`
	Operation string        `json:"operation"`
	Timestamp time.Time     `json:"timestamp"`
	TraceID   string        `json:"trace_id"`
	Severity  ErrorSeverity `json:"severity"`

	// 错误分类
	Category  ErrorCategory `json:"category"`
	UserError bool          `json:"user_error"` // 是否为用户输入错误

	// HTTP相关
	HTTPStatusCode int               `json:"http_status_code"`
	HTTPHeaders    map[string]string `json:"http_headers,omitempty"`

	// 重试信息
	Retryable  bool          `json:"retryable"`
	RetryDelay time.Duration `json:"retry_delay,omitempty"`
	RetryCount int           `json:"retry_count,omitempty"`

	// 上下文信息
	Context map[string]interface{} `json:"context,omitempty"`

	// 原始错误
	Cause error `json:"-"`
}

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

type DefaultTraceGenerator struct{}

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

type ErrorCategory string

type ErrorCode string

type ErrorCollection struct {
	Errors []*AppError `json:"errors"`
	Total  int         `json:"total"`
}

type ErrorConfig struct {
	Code           ErrorCode
	Message        string
	HTTPStatusCode int
	Severity       ErrorSeverity
	Category       ErrorCategory
	UserError      bool
	Retryable      bool
	DefaultDetails string
}

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

type ErrorInfo struct {
	Code       ErrorCode              `json:"code"`
	Message    string                 `json:"message"`
	Details    string                 `json:"details,omitempty"`
	Operation  string                 `json:"operation,omitempty"`
	TraceID    string                 `json:"trace_id,omitempty"`
	Severity   ErrorSeverity          `json:"severity,omitempty"`
	Retryable  bool                   `json:"retryable,omitempty"`
	RetryDelay *time.Duration         `json:"retry_delay,omitempty"`
	Context    map[string]interface{} `json:"context,omitempty"`
}

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

type ErrorMetrics struct {
	Code      ErrorCode     `json:"code"`
	Operation string        `json:"operation"`
	Count     int64         `json:"count"`
	FirstSeen time.Time     `json:"first_seen"`
	LastSeen  time.Time     `json:"last_seen"`
	Duration  time.Duration `json:"duration"`
	Severity  ErrorSeverity `json:"severity"`
}

type ErrorSeverity string

type ErrorStats struct {
	TotalErrors      int64                   `json:"total_errors"`
	ErrorsByCode     map[ErrorCode]int64     `json:"errors_by_code"`
	ErrorsBySeverity map[ErrorSeverity]int64 `json:"errors_by_severity"`
	ErrorsByCategory map[ErrorCategory]int64 `json:"errors_by_category"`
	RecentErrors     []*AppError             `json:"recent_errors,omitempty"`
	TimeRange        TimeRange               `json:"time_range"`
}

type LogLevel string

type Metadata struct {
	RequestID   string        `json:"request_id"`
	Version     string        `json:"version"`
	Duration    time.Duration `json:"duration,omitempty"`
	Timestamp   time.Time     `json:"timestamp"`
	Pagination  *Pagination   `json:"pagination,omitempty"`
	Performance *Performance  `json:"performance,omitempty"`
}

type MetricsCollector interface {
	IncrementErrorCount(code ErrorCode, severity ErrorSeverity, category ErrorCategory)
	RecordErrorDuration(code ErrorCode, duration time.Duration)
	IncrementHTTPRequestCount(method, path, statusCode string)
	RecordHTTPRequestDuration(method, path string, duration time.Duration)
}

type Pagination struct {
	Page       int   `json:"page"`
	PageSize   int   `json:"page_size"`
	Total      int64 `json:"total"`
	TotalPages int   `json:"total_pages"`
	HasNext    bool  `json:"has_next"`
	HasPrev    bool  `json:"has_prev"`
}

type Performance struct {
	DatabaseQueries int           `json:"database_queries,omitempty"`
	DatabaseTime    time.Duration `json:"database_time,omitempty"`
	CacheHits       int           `json:"cache_hits,omitempty"`
	CacheMisses     int           `json:"cache_misses,omitempty"`
	ExternalCalls   int           `json:"external_calls,omitempty"`
	ExternalTime    time.Duration `json:"external_time,omitempty"`
}

type ResponseBuilder[T any] struct {
	// contains filtered or unexported fields
}

type ResponseType string

type TimeRange struct {
	Start time.Time `json:"start"`
	End   time.Time `json:"end"`
}

type TraceGenerator interface {
	GenerateTraceID() string
}