errors

const (
	// CategorySuccess indicates no error occurred.
	CategorySuccess ErrorCategory = "success"

	// CategoryClientError indicates a 4xx HTTP response.
	// These are permanent failures that should never be retried
	// (bad request, unauthorized, forbidden, not found, etc.).
	CategoryClientError ErrorCategory = "client_error"

	// CategoryServerError indicates a 5xx HTTP response.
	// These are temporary server-side failures that should be retried.
	CategoryServerError ErrorCategory = "server_error"

	// CategoryTimeout indicates a request or connection timeout.
	// Retryable - the server may recover.
	CategoryTimeout ErrorCategory = "timeout"

	// CategoryDNSError indicates the domain could not be resolved.
	// Typically persistent - suggests misconfigured webhook URL.
	CategoryDNSError ErrorCategory = "dns_error"

	// CategoryTLSError indicates a TLS/SSL handshake failure.
	// Usually persistent - certificate issues, protocol mismatch, etc.
	CategoryTLSError ErrorCategory = "tls_error"

	// CategoryConnectionRefused indicates the target actively refused the connection.
	// May be temporary (service restarting) or permanent (wrong port).
	CategoryConnectionRefused ErrorCategory = "connection_refused"

	// CategoryNetworkError covers other network-level errors:
	// connection reset, host unreachable, broken pipe, etc.
	// Typically retryable.
	CategoryNetworkError ErrorCategory = "network_error"

	// CategoryRateLimited indicates a 429 Too Many Requests response.
	// Retryable - the server is temporarily rejecting requests due to rate
	// limiting. The delivery should be retried after the Retry-After period.
	CategoryRateLimited ErrorCategory = "rate_limited"

	// CategoryUnexpectedStatus indicates the HTTP response code did not match
	// the webhook's configured expected_status_codes. For example, a 201 response
	// when only 200 is expected. The server responded, but the status is not
	// considered successful by the webhook's configuration.
	// Not retryable - the target responded correctly from its perspective;
	// the mismatch is a configuration or contract issue.
	CategoryUnexpectedStatus ErrorCategory = "unexpected_status"

	// CategoryUnknown is used when the error cannot be classified.
	CategoryUnknown ErrorCategory = "unknown"
)