api

type EmptyReq struct{}

type Error struct {
	// Status is the HTTP status code.
	Status int
	// Code is the machine-readable error code.
	Code ErrorCode
	// Message is the client-facing error message.
	Message string
	// Details holds optional unstructured diagnostics.
	Details map[string]any
	// Cause is the optional underlying error.
	Cause error
}

type ErrorCode string

type ErrorDetails struct {
	// Code is the machine-readable error code.
	Code ErrorCode `json:"code"`
	// Message is the human-readable error message.
	Message string `json:"message"`
}

type ErrorResponse struct {
	// Error contains the machine-readable code and human-readable message.
	Error ErrorDetails `json:"error"`
	// Details contains optional endpoint-specific structured error context.
	Details map[string]any `json:"details,omitempty"`
}

type Validatable interface {
	Validate() error
}