http

type CircuitBreakerOptions struct {
	// Name 标识熔断器（状态回调与日志中的 breaker 名），缺省
	// "http-client"。
	Name string
	// MaxRequests 是 half-open 态放行的探测请求数；0 表示只放行 1 个
	//（gobreaker 语义）。
	MaxRequests uint32
	// Interval 是 closed 态计数的周期清零间隔（固定窗口）；0 表示不
	// 周期清零。
	Interval time.Duration
	// Timeout 是 open 态时长，到期转 half-open 放行探测；<=0 默认 60s。
	Timeout time.Duration
	// MinConsecutiveFailures 是连续失败多少次后打开熔断；0 默认 5。
	// 客户端主动取消（ctx 取消/超时）不计入失败（见 newCircuitBreaker
	// 的排除规则）。
	MinConsecutiveFailures uint32
	// FailureStatusCodes 额外计入失败的响应状态码。缺省仅传输层错误
	//（err != nil）算失败——HTTP 4xx/5xx 是对端的正常响应语义；运维
	// 认定"对端 503 = 下游不可用"时按需加入。
	FailureStatusCodes []int
	// OnStateChange 在状态迁移时回调（from/to 取 "closed"/"open"/
	// "half-open"）。框架侧同时记录 Info 日志；需要桥接 eventbus 的
	// 应用在此回调里自行 Publish。
	OnStateChange func(name, from, to string)
}

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

type Option func(*Options)

type Options struct {
	// Timeout 为整体超时，0 表示无超时。
	Timeout time.Duration
	// TracerProvider 为插装使用的 TracerProvider，nil 时用全局（缺省 noop）。
	TracerProvider trace.TracerProvider
	// Propagator 为传播上下文注入使用的 TextMapPropagator，nil 时用全局。
	Propagator propagation.TextMapPropagator
	// Logger 为重试等内部日志使用的实例，nil 时用 slog.Default()。
	Logger *slog.Logger
	// Retry 非 nil 时启用重试（WithRetry 装配）。
	Retry *RetryOptions
	// CircuitBreaker 非 nil 时启用出站熔断（WithCircuitBreaker 装配，
	// 集成于重试之外层，见 circuitbreaker.go）。
	CircuitBreaker *CircuitBreakerOptions
	// ClientOptions 透传配置底层 *http.Client 的逃生口。
	ClientOptions func(*http.Client)
}

type RetryOption func(*RetryOptions)

type RetryOptions struct {
	// MaxAttempts 为总尝试次数（含首次）。
	MaxAttempts int
	// InitialInterval 为首次重试等待的基准时长（指数退避起点）。
	InitialInterval time.Duration
	// MaxInterval 为退避等待时长的上限。
	MaxInterval time.Duration
}