errors

type Error struct {
	// Code is the HTTP-style status code (e.g., 400, 401, 500).
	Code int `json:"code,omitempty"`

	// Reason is a short error identifier (e.g., "InvalidParams", "Unauthorized").
	Reason string `json:"reason,omitempty"`

	// Message is a human-readable error description.
	Message string `json:"message,omitempty"`

	// Metadata holds additional key-value data about the error.
	Metadata map[string]string `json:"metadata,omitempty"`
}