cache

type AlwaysStaleChecker struct{}

type CacheResult[T any] struct {
	Data      T
	FromCache bool
}

type CacheService interface {
	// Single-date operations
	GetCycleForDate(ctx context.Context, date time.Time) (*CacheResult[*whoop.Cycle], error)
	GetRecoveryForCycle(ctx context.Context, cycleID int64) (*CacheResult[*whoop.Recovery], error)
	GetSleepForCycle(ctx context.Context, cycleID int64) (*CacheResult[*whoop.Sleep], error)
	GetWorkoutsForDateRange(ctx context.Context, start, end time.Time) (*CacheResult[[]whoop.Workout], error)

	// Range operations (for charts, historical data)
	GetCyclesForRange(ctx context.Context, start, end time.Time) (*DateRangeResult[whoop.Cycle], error)
	GetRecoveriesForRange(ctx context.Context, start, end time.Time) (*DateRangeResult[whoop.Recovery], error)
	GetSleepsForRange(ctx context.Context, start, end time.Time) (*DateRangeResult[whoop.Sleep], error)

	// Calendar-specific (fetches recoveries and cycles for proper date mapping)
	GetCalendarData(ctx context.Context, month time.Time) (*CalendarData, error)

	// Historical bundle (30-day data for charts)
	GetHistoricalData(ctx context.Context, referenceDate time.Time, days int) (*HistoricalData, error)

	// SetAPIKey updates the API key on the underlying client (called after OAuth flow)
	SetAPIKey(apiKey string)
}

type CalendarData struct {
	Recoveries []whoop.Recovery
	Cycles     []whoop.Cycle
	FromCache  bool
}

type DateRangeResult[T any] struct {
	Records      []T
	FromCache    bool
	PartialCache bool // some from cache, some from API
}

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

type HistoricalData struct {
	Cycles     []whoop.Cycle
	Recoveries []whoop.Recovery
	Sleeps     []whoop.Sleep
	Workouts   []whoop.Workout
	FromCache  bool
}

type NeverStaleChecker struct{}

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

type StalenessChecker interface {
	// ShouldRefresh returns true if the cached data is stale and should be re-fetched.
	ShouldRefresh(scoreState whoop.ScoreState, dataDate, fetchedAt time.Time) bool
}