// 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) }