ewrap

Dec 10, 2025

Changes in this version

type CircuitBreaker

+ func NewCircuitBreakerWithObserver(name string, maxFailures int, timeout time.Duration, observer Observer) *CircuitBreaker

+ func (cb *CircuitBreaker) SetObserver(observer Observer)

type Error

+ func (e *Error) GetStackFrames() []StackFrame

+ func (e *Error) GetStackIterator() *StackIterator

type ErrorGroup

+ func (eg *ErrorGroup) MarshalJSON() ([]byte, error)

+ func (eg *ErrorGroup) MarshalYAML() (any, error)

+ func (eg *ErrorGroup) ToJSON() (string, error)

+ func (eg *ErrorGroup) ToSerialization() ErrorGroupSerialization

+ func (eg *ErrorGroup) ToYAML() (string, error)

+ type ErrorGroupSerialization struct

+ ErrorCount int

+ Errors []SerializableError

+ Timestamp string

type Option

+ func WithObserver(observer Observer) Option

+ type SerializableError struct

+ Cause *SerializableError

+ Message string

+ Metadata map[string]any

+ StackTrace []StackFrame

+ Type string

+ type StackFrame struct

+ File string

+ Function string

+ Line int

+ PC uintptr

+ type StackIterator struct

+ func NewStackIterator(pcs []uintptr) *StackIterator

+ func (si *StackIterator) AllFrames() []StackFrame

+ func (si *StackIterator) Frames() []StackFrame

+ func (si *StackIterator) HasNext() bool

+ func (si *StackIterator) Next() *StackFrame

+ func (si *StackIterator) Reset()

+ type StackTrace []StackFrame

Aug 19, 2025

Changes in this version

+ func GetMetadataValue[T any](e *Error, key string) (T, bool)

+ func SetObserver(o Observer)

type Error

+ func (e *Error) GetErrorContext() *ErrorContext

+ func (e *Error) WithContext(ctx *ErrorContext) *Error

type ErrorGroup

+ func (eg *ErrorGroup) Join() error

type ErrorOutput

+ Recovery *RecoverySuggestion

+ type Observer interface

+ RecordCircuitStateTransition func(name string, from, to CircuitState)

+ RecordError func(message string)

type Option

+ func WithRecoverySuggestion(rs *RecoverySuggestion) Option

+ type RetryOption func(*RetryInfo)

+ func WithRetryShould(fn func(error) bool) RetryOption

Jun 10, 2025

Changes in this version

+ func CaptureStack() []uintptr

+ type CircuitBreaker struct

+ func NewCircuitBreaker(name string, maxFailures int, timeout time.Duration) *CircuitBreaker

+ func (cb *CircuitBreaker) CanExecute() bool

+ func (cb *CircuitBreaker) OnStateChange(callback func(name string, from, to CircuitState))

+ func (cb *CircuitBreaker) RecordFailure()

+ func (cb *CircuitBreaker) RecordSuccess()

+ type CircuitState int

+ const CircuitClosed

+ const CircuitHalfOpen

+ const CircuitOpen

+ type Error struct

+ func New(msg string, opts ...Option) *Error

+ func Newf(format string, args ...any) *Error

+ func Wrap(err error, msg string, opts ...Option) *Error

+ func Wrapf(err error, format string, args ...any) *Error

+ func (e *Error) CanRetry() bool

+ func (e *Error) Cause() error

+ func (e *Error) Error() string

+ func (e *Error) GetMetadata(key string) (any, bool)

+ func (e *Error) IncrementRetry()

+ func (e *Error) Is(target error) bool

+ func (e *Error) Log()

+ func (e *Error) Stack() string

+ func (e *Error) ToJSON(opts ...FormatOption) (string, error)

+ func (e *Error) ToYAML(opts ...FormatOption) (string, error)

+ func (e *Error) Unwrap() error

+ func (e *Error) WithMetadata(key string, value any) *Error

+ type ErrorContext struct

+ Component string

+ Data map[string]any

+ Environment string

+ File string

+ Line int

+ Operation string

+ RequestID string

+ Severity Severity

+ Timestamp time.Time

+ Type ErrorType

+ User string

+ Version string

+ func (ec *ErrorContext) String() string

+ type ErrorGroup struct

+ func NewErrorGroup() *ErrorGroup

+ func (eg *ErrorGroup) Add(err error)

+ func (eg *ErrorGroup) Clear()

+ func (eg *ErrorGroup) Error() string

+ func (eg *ErrorGroup) ErrorOrNil() error

+ func (eg *ErrorGroup) Errors() []error

+ func (eg *ErrorGroup) HasErrors() bool

+ func (eg *ErrorGroup) Release()

+ type ErrorGroupPool struct

+ func NewErrorGroupPool(initialCapacity int) *ErrorGroupPool

+ func (p *ErrorGroupPool) Get() *ErrorGroup

+ type ErrorOutput struct

+ Cause *ErrorOutput

+ Context map[string]any

+ Message string

+ Metadata map[string]any

+ Severity string

+ Stack string

+ Timestamp time.Time

+ Type string

+ type ErrorType int

+ const ErrorTypeConfiguration

+ const ErrorTypeDatabase

+ const ErrorTypeExternal

+ const ErrorTypeInternal

+ const ErrorTypeNetwork

+ const ErrorTypeNotFound

+ const ErrorTypePermission

+ const ErrorTypeUnknown

+ const ErrorTypeValidation

+ func (et ErrorType) String() string

+ type FormatOption func(*ErrorOutput)

+ func WithStackTrace(include bool) FormatOption

+ func WithTimestampFormat(format string) FormatOption

+ type Option func(*Error)

+ func WithContext(ctx context.Context, errorType ErrorType, severity Severity) Option

+ func WithLogger(logger logger.Logger) Option

+ func WithRetry(maxAttempts int, delay time.Duration) Option

+ type RecoverySuggestion struct

+ Actions []string

+ Documentation string

+ Message string

+ type RetryInfo struct

+ CurrentAttempt int

+ Delay time.Duration

+ LastAttempt time.Time

+ MaxAttempts int

+ ShouldRetry func(error) bool

+ type Severity int

+ const SeverityCritical

+ const SeverityError

+ const SeverityInfo

+ const SeverityWarning

+ func (s Severity) String() string