milestones

type Checker struct {
	Store Store
	// Input loads the vehicle's whole ledger input.
	Input func(ctx context.Context, uid uuid.UUID, rivianID string) (ledger.Input, error)
	// Lease says how far through its lease the vehicle is; Total 0 when none.
	Lease func(ctx context.Context, uid uuid.UUID, vehicle uuid.UUID) LeaseTerm
	// Push sends the milestone to the account's devices that have it on, through
	// engage; nil sends nothing (the card still appears).
	Push   func(ctx context.Context, uid uuid.UUID, vehicle uuid.UUID, r Row)
	Now    func() time.Time
	Logger *slog.Logger
}

type Detail struct {
	Miles       float64 `json:"miles,omitempty"`
	MiPerKWh    float64 `json:"mi_per_kwh,omitempty"`
	CostPerMile float64 `json:"cost_per_mile,omitempty"`
	Currency    string  `json:"currency,omitempty"`
	HomeKWh     float64 `json:"home_kwh,omitempty"`
	HomeCost    float64 `json:"home_cost,omitempty"`
	Charges     int     `json:"charges,omitempty"`
	KWhAdded    float64 `json:"kwh_added,omitempty"`
	DriveMiles  float64 `json:"drive_miles,omitempty"`
	DriveMiKWh  float64 `json:"drive_mi_per_kwh,omitempty"`
	LeaseDays   int     `json:"lease_days_elapsed,omitempty"`
	LeaseTotal  int     `json:"lease_days_total,omitempty"`
}

type Found struct {
	Key    string
	Kind   string
	Detail Detail
}

type LeaseTerm struct{ Elapsed, Total int }

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

type Row struct {
	User        uuid.UUID
	Vehicle     uuid.UUID
	RivianID    string
	Key, Kind   string
	Status      string
	AchievedAt  time.Time
	Detail      Detail
	DismissedAt *time.Time
}

type Store interface {
	// Ready reports whether the one-off backfill has finished.
	Ready(ctx context.Context) (bool, error)
	MarkReady(ctx context.Context) error
	// Insert adds a milestone row; false when it already exists.
	Insert(ctx context.Context, r Row) (bool, error)
	// Vehicle maps a Rivian vehicle id to the account's vehicle row.
	Vehicle(ctx context.Context, uid uuid.UUID, rivianID string) (uuid.UUID, bool, error)
	// Vehicles lists accounts' vehicles; active limits it to those with a drive or
	// charge since the given time (the zero time: all).
	Vehicles(ctx context.Context, active time.Time) ([]VehicleRef, error)
	// PendingPush lists achieved, undismissed milestones achieved since the
	// cutoff whose push was never claimed (no engagement_sends row for their
	// claim key, whatever its status), oldest first.
	PendingPush(ctx context.Context, since time.Time) ([]Row, error)
}

type VehicleRef struct {
	User     uuid.UUID
	ID       uuid.UUID
	RivianID string
}