usage

type Client struct {
	BaseURL    string
	Token      string
	HTTPClient *http.Client
}

type Poller struct {
	Client   *Client
	Interval time.Duration
	// KeepStaleFor is how long the last good providers survive while Redline is
	// unavailable. Defaults to 15 minutes.
	KeepStaleFor time.Duration
	// Now defaults to time.Now; tests inject a clock.
	Now func() time.Time
	// OnChange is called whenever the marshalled payload differs from the
	// previous one.
	OnChange func(Usage)

	// Logger receives state transitions and refresh failures. A nil Logger
	// discards them, which is what a Bubble Tea TUI needs: stray writes to
	// stderr corrupt the display.
	Logger *log.Logger
	// contains filtered or unexported fields
}

type Provider struct {
	ID       string `json:"id"`
	Provider string `json:"provider"`
	Label    string `json:"label"`

	State ProviderState `json:"state"`
	// Error is populated only when State is ProviderError (no usable snapshot).
	// Redline's per-account error text can contain filesystem paths, so it is
	// deliberately dropped for the ok/stale cases where a usable snapshot exists
	// alongside it. Capped at 200 runes.
	Error      string    `json:"error,omitempty"`
	Source     string    `json:"source,omitempty"`
	ObservedAt time.Time `json:"observed_at"`
	// Primary is the account-scoped window shown without a click; nil when the
	// account exposes no account-scoped window at all. When non-nil its Key
	// always matches exactly one Windows entry (the labels differ: "5h"/"wk"
	// here versus the expanded-view label in Windows).
	Primary *Window  `json:"primary,omitempty"`
	Windows []Window `json:"windows"`
}

type ProviderState string

type RefreshResult struct {
	// Usage is the state after the refresh, or the cached state when throttled.
	Usage Usage
	// Throttled is true when the call did not contact Redline because another
	// refresh is in flight or one ran less than RefreshMinSpacing ago.
	Throttled bool
	// RetryAfter is how long until a refresh would be accepted; only meaningful
	// when Throttled.
	RetryAfter time.Duration
}

type State string

type Usage struct {
	State State `json:"state"`
	// Message is human-readable text for the unavailable and disabled states.
	Message string `json:"message,omitempty"`
	// UpdatedAt is when DevX last read Redline successfully.
	UpdatedAt time.Time  `json:"updated_at"`
	Providers []Provider `json:"providers"`
}

type Window struct {
	Key   string `json:"key"`
	Label string `json:"label"`
	Scope string `json:"scope"`
	// Remaining is the fraction of the allowance left, 0..1.
	Remaining     float64   `json:"remaining"`
	ResetsAt      time.Time `json:"resets_at"`
	PeriodSeconds int64     `json:"period_seconds,omitempty"`
	ResetInferred bool      `json:"reset_inferred,omitempty"`
}