api

type APIError struct {
	Code      string `json:"code"`              // Machine-readable error code
	Message   string `json:"message"`           // Human-readable error message
	RequestID string `json:"request_id"`        // Request ID for support/debugging
	Details   any    `json:"details,omitempty"` // Optional additional context
}

type AuditLogger interface {
	ConfigReload(actor, result string, details map[string]string)
	RefreshStart(actor string, bouquets []string)
	RefreshComplete(actor string, channels, bouquets int, durationMS int64)
	RefreshError(actor, reason string)
	AuthSuccess(remoteAddr, endpoint string)
	AuthFailure(remoteAddr, endpoint, reason string)
	AuthMissing(remoteAddr, endpoint string)
	RateLimitExceeded(remoteAddr, endpoint string)
}

type AuthService interface {
	ValidateToken(ctx context.Context, token string) (principal string, err error)
	Authorize(principal, action, resource string) bool
}

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

type CircuitBreakerOption func(*CircuitBreaker)

type ConfigHolder interface {
	Get() jobs.Config
	Reload(ctx context.Context) error
}

type DeprecationConfig struct {
	SunsetVersion string // Version when the deprecated API will be removed
	SunsetDate    string // Date when the deprecated API will be removed (RFC3339 format)
	SuccessorPath string // Path to the successor API version
}

type Deps struct {
	Log     Logger
	Metrics Metrics
	Auth    AuthService
	Refresh RefreshService
	Store   Store
	Config  jobs.Config
}

type Logger interface {
	Info() *zerolog.Event
	Warn() *zerolog.Event
	Error() *zerolog.Event
	Debug() *zerolog.Event
}

type Metrics interface {
	Inc(name string, labels ...string)
	Observe(name string, v float64, labels ...string)
}

type RateLimitAuditor interface {
	RateLimitExceeded(remoteAddr, endpoint string)
}

type RefreshService interface {
	Trigger(ctx context.Context, opts jobs.Options) (*jobs.Artifacts, error)
}

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

type Store interface {
	Open(name string) (io.ReadSeeker, error)
	Stat(name string) (size int64, mod time.Time, err error)
}