errors

package

v0.2.1 Latest Latest Go to latest Published: Apr 15, 2026 License: MIT Imports: 4 Imported by: 0

Details

This section is empty.

This section is empty.

func IsNotFound(err error) bool

func ToHTTP(err error, w http.ResponseWriter)

ToHTTP writes a structured JSON error response. Handlers call this in their error paths — no error-handling middleware needed.

type Code int

Code is an enum of domain error codes. Maps to HTTP status codes for the server, and to exit codes / user messages for the CLI.

const (
	CodeUnknown Code = iota
	CodeNotFound
	CodeConflict
	CodeBadRequest
	CodeUnauthorized
	CodeForbidden
	CodeInternal
)

type Error struct {
	// contains filtered or unexported fields
}

Error is the single error type for all domain errors. Handlers use ToHTTP() to convert it; CLI commands inspect Code() for UX.

func Conflict(resource, slug string) *Error

func New(code Code, message string) *Error

func NotFound(resource, slug string) *Error

func (e *Error) Code() Code

func (e *Error) Error() string

func (e *Error) HTTPStatus() int

func (e *Error) Hint() string

func (e *Error) WithHint(hint string) *Error

type RefError struct {
	Err         *Error
	InvalidRefs map[string]any
}

RefError carries structured invalid-reference details alongside a validation error. Used by RefChecker and surfaced in API responses.

func (e *RefError) Error() string

func (e *RefError) Unwrap() error