55 lines
1.6 KiB
Go
55 lines
1.6 KiB
Go
// Package apperr is the application's error vocabulary: every module reports
|
|
// failures as a Kind plus a message that is safe to show to clients, and the
|
|
// transport layer owns the only mapping from Kind to HTTP status. Causes are
|
|
// kept for logs but never rendered.
|
|
package apperr
|
|
|
|
import "errors"
|
|
|
|
type Kind int
|
|
|
|
const (
|
|
KindInternal Kind = iota
|
|
KindInvalid
|
|
KindUnauthorized
|
|
KindNotFound
|
|
KindConflict
|
|
KindPayloadTooLarge
|
|
KindUnsupportedMedia
|
|
KindUnavailable
|
|
)
|
|
|
|
type Error struct {
|
|
Kind Kind
|
|
Message string
|
|
Cause error
|
|
}
|
|
|
|
func (e *Error) Error() string { return e.Message }
|
|
|
|
func (e *Error) Unwrap() error { return e.Cause }
|
|
|
|
func New(kind Kind, message string) *Error {
|
|
return &Error{Kind: kind, Message: message}
|
|
}
|
|
|
|
func Wrap(kind Kind, message string, cause error) *Error {
|
|
return &Error{Kind: kind, Message: message, Cause: cause}
|
|
}
|
|
|
|
// KindOf classifies any error; foreign errors are internal.
|
|
func KindOf(err error) Kind {
|
|
if e, ok := errors.AsType[*Error](err); ok {
|
|
return e.Kind
|
|
}
|
|
return KindInternal
|
|
}
|
|
|
|
func Invalid(message string) *Error { return New(KindInvalid, message) }
|
|
func Unauthorized(message string) *Error { return New(KindUnauthorized, message) }
|
|
func NotFound(message string) *Error { return New(KindNotFound, message) }
|
|
func Conflict(message string) *Error { return New(KindConflict, message) }
|
|
func PayloadTooLarge(message string) *Error { return New(KindPayloadTooLarge, message) }
|
|
func UnsupportedMedia(message string) *Error { return New(KindUnsupportedMedia, message) }
|
|
func Unavailable(message string) *Error { return New(KindUnavailable, message) }
|