errors

Jul 17, 2026

Changes in this version

type AuthenticationError

+ func (e *AuthenticationError) Context() map[string]any

type ConflictError

+ func (e *ConflictError) Context() map[string]any

type DatabaseError

+ func (e *DatabaseError) Context() map[string]any

type ExternalAPIError

+ func (e *ExternalAPIError) Context() map[string]any

type InternalError

+ func (e *InternalError) Context() map[string]any

type NotFoundError

+ func (e *NotFoundError) Context() map[string]any

type RateLimitError

+ func (e *RateLimitError) Context() map[string]any

type ValidationError

+ func (e *ValidationError) Context() map[string]any

Jul 17, 2026

Changes in this version

type ExternalAPIError

+ func (e *ExternalAPIError) SetRetryAfter(seconds int)

Jul 17, 2026

Changes in this version

+ type Renderer struct

+ func NewRenderer(cfg RendererConfig) (*Renderer, error)

+ func (r *Renderer) HTML(w http.ResponseWriter, err error) WriteResult

+ func (r *Renderer) JSON(w http.ResponseWriter, err error) WriteResult

+ func (r *Renderer) Middleware() func(http.Handler) http.Handler

+ func (r *Renderer) Problem(w http.ResponseWriter, err error) WriteResult

+ type RendererConfig struct

+ DefaultAuthenticateChallenge string

+ HeaderPolicy HeaderPolicy

+ Logger Logger

+ RecoveryHeaderPolicy HeaderPolicy

+ StatusCodes map[ErrorCode]int

Jul 17, 2026

Changes in this version

type WriteResult

+ BytesWritten int

Jul 17, 2026

Changes in this version

+ func SetHeaderPolicy(p HeaderPolicy)

+ func SetRecoveryHeaderPolicy(p HeaderPolicy)

+ type HeaderPolicy struct

+ ClearValidators bool

+ KeepContentEncoding bool

Jul 17, 2026

Changes in this version

+ func SetDefaultAuthenticateChallenge(challenge string)

Jul 17, 2026

Changes in this version

+ type WriteResult struct

+ RenderErr error

+ Status int

+ WriteErr error

+ func WriteHTMLResult(w http.ResponseWriter, err error) WriteResult

+ func WriteJSONResult(w http.ResponseWriter, err error) WriteResult

+ func WriteProblemResult(w http.ResponseWriter, err error) WriteResult

Jul 16, 2026

Changes in this version

type AuthenticationError

+ func WrapAuthenticationError(err error, reason, message string) *AuthenticationError

+ type Authenticator interface

+ AuthenticateChallenge func() (string, bool)

type BaseError

+ func (e *BaseError) AuthenticateChallenge() (string, bool)

+ func (e *BaseError) SetAuthenticateChallenge(challenge string)

type ConflictError

+ func WrapConflictError(err error, resourceType, conflictKey, message string) *ConflictError

type NotFoundError

+ func WrapNotFoundError(err error, resourceType, resourceID string) *NotFoundError

type RateLimitError

+ func WrapRateLimitError(err error, service string, limit, retryAfter int) *RateLimitError

Jul 16, 2026

Changes in this version

type BaseError

+ func (e *BaseError) ProblemTitle() (string, bool)

+ func (e *BaseError) SetProblemTitle(title string)

+ type ProblemTitler interface

+ ProblemTitle func() (string, bool)

Jul 16, 2026

Changes in this version

type BaseError

+ func (e *BaseError) ProblemInstance() (string, bool)

+ func (e *BaseError) ProblemType() (string, bool)

+ func (e *BaseError) PublicDetails() (add map[string]interface{}, remove map[string]struct{})

+ func (e *BaseError) RemovePublicDetail(key string)

+ func (e *BaseError) SetProblemInstance(uri string)

+ func (e *BaseError) SetProblemType(uri string)

+ func (e *BaseError) SetPublicDetail(key string, value interface{})

+ type ProblemInstancer interface

+ ProblemInstance func() (string, bool)

+ type ProblemTyper interface

+ ProblemType func() (string, bool)

+ type PublicDetailer interface

+ PublicDetails func() (add map[string]interface{}, remove map[string]struct{})

Jul 16, 2026

Changes in this version

+ func WriteHTML(w http.ResponseWriter, err error) int

+ func WriteJSON(w http.ResponseWriter, err error) int

+ func WriteProblem(w http.ResponseWriter, err error) int

Jul 16, 2026

Changes in this version

+ func RegisterStatusCode(code ErrorCode, status int)

+ func WriteHTTPProblem(w http.ResponseWriter, err error, logger Logger)

type BaseError

+ func New(code ErrorCode, message string) *BaseError

+ func Wrap(err error, code ErrorCode, message string) *BaseError

+ type Coder interface

+ Code func() ErrorCode

+ type ProblemDetails struct

+ Code ErrorCode

+ Detail string

+ Extensions map[string]interface{}

+ Instance string

+ Status int

+ Title string

+ Type string

+ func (p ProblemDetails) MarshalJSON() ([]byte, error)

+ type PublicMessager interface

+ PublicMessage func() (string, bool)

+ type StackTracer interface

+ StackTrace func() []string

Jul 15, 2026

Changes in this version

+ func RecaptureStackTrace(err error, extraSkip int)

type BaseError

+ func (e *BaseError) PublicMessage() (string, bool)

+ func (e *BaseError) SetPublicMessage(msg string)

Jul 15, 2026

Changes in this version

+ func UserMessage(err error) string

Jul 15, 2026

Changes in this version

+ func GetStackTrace(err error) []string

+ func HTTPStatusCode(code ErrorCode) int

+ func RecoveryMiddleware(logger Logger) func(http.Handler) http.Handler

+ func WriteHTTPError(w http.ResponseWriter, err error, logger Logger)

+ func WriteHTTPErrorHTML(w http.ResponseWriter, err error, logger Logger)

+ type AuthenticationError struct

+ Reason string

+ SessionID string

+ func NewAuthenticationError(reason, message string) *AuthenticationError

+ type BaseError struct

+ func (e *BaseError) Code() ErrorCode

+ func (e *BaseError) Context() map[string]interface{}

+ func (e *BaseError) Error() string

+ func (e *BaseError) StackTrace() []string

+ func (e *BaseError) Unwrap() error

+ type ConflictError struct

+ ConflictKey string

+ ResourceType string

+ func NewConflictError(resourceType, conflictKey, message string) *ConflictError

+ type DatabaseError struct

+ Operation string

+ Query string

+ func NewDatabaseError(operation, message string) *DatabaseError

+ func WrapDatabaseError(err error, operation, query string) *DatabaseError

+ type ErrorCode string

+ const ErrCodeAlreadyExists

+ const ErrCodeConstraintViolation

+ const ErrCodeDatabaseConnection

+ const ErrCodeDatabaseMigration

+ const ErrCodeDatabaseQuery

+ const ErrCodeDatabaseTransaction

+ const ErrCodeExternalAPI

+ const ErrCodeInternal

+ const ErrCodeInvalidFormat

+ const ErrCodeInvalidInput

+ const ErrCodeMissingRequired

+ const ErrCodeNotFound

+ const ErrCodeNotImplemented

+ const ErrCodePanic

+ const ErrCodePermissionDenied

+ const ErrCodeQuotaExceeded

+ const ErrCodeRateLimitExceeded

+ const ErrCodeResourceConflict

+ const ErrCodeTokenExpired

+ const ErrCodeTokenInvalid

+ const ErrCodeUnauthorized

+ func GetErrorCode(err error) ErrorCode

+ type ErrorDetail struct

+ Code ErrorCode

+ Details map[string]interface{}

+ Message string

+ type ErrorWithCode interface

+ Code func() ErrorCode

+ StackTrace func() []string

+ Unwrap func() error

+ type ExternalAPIError struct

+ RetryAfter *int

+ Service string

+ StatusCode int

+ URL string

+ func NewExternalAPIError(service, message string, statusCode int, url string) *ExternalAPIError

+ func WrapExternalAPIError(err error, service, url string, statusCode int) *ExternalAPIError

+ type HTTPErrorResponse struct

+ Error ErrorDetail

+ type InternalError struct

+ Component string

+ func NewInternalError(component, message string) *InternalError

+ func WrapInternalError(err error, component, message string) *InternalError

+ type Level int

+ const LevelError

+ const LevelInfo

+ const LevelWarn

+ type Logger interface

+ Log func(level Level, err error, fields map[string]interface{}, msg string)

+ type NotFoundError struct

+ ResourceID string

+ ResourceType string

+ func NewNotFoundError(resourceType, resourceID string) *NotFoundError

+ type RateLimitError struct

+ Limit int

+ RetryAfter int

+ Service string

+ func NewRateLimitError(service string, limit, retryAfter int) *RateLimitError

+ type ValidationError struct

+ Field string

+ Value interface{}

+ func NewValidationError(message string, field string, value interface{}) *ValidationError

+ func WrapValidationError(err error, message string, field string) *ValidationError