apperr

package

v0.16.0 Latest Latest Go to latest Published: Oct 9, 2026 License: MIT Imports: 6 Imported by: 0

Details

Package apperr defines transport-neutral application errors.

This section is empty.

This section is empty.

func CodeOf(err error) int

CodeOf extracts the stable application code.

func GRPCStatus(err error) error

GRPCStatus maps an application error to a gRPC status error without exposing its internal cause.

func HTTPStatus(err error) int

HTTPStatus maps an application error code to an HTTP status.

func PublicMessage(err error) string

PublicMessage returns a safe client-facing message.

func Retryable(err error) bool

Retryable reports whether an error was explicitly marked retryable.

type Error struct {
	Code      int
	Message   string
	Cause     error
	Retryable bool
}

Error contains a stable public code/message and an optional internal cause. Message is intended for clients; details from Cause must only be logged.

func New(code int, message string) *Error

New creates a public application error.

func Wrap(code int, message string, cause error) *Error

Wrap creates an application error while retaining an internal cause.

func (e *Error) Error() string

func (e *Error) Unwrap() error

func (e *Error) WithRetryable(retryable bool) *Error

WithRetryable marks an error as safe for a retry policy.