charges

type Charge struct {
	ID             string
	VehicleID      string
	StartedAt      time.Time
	EndedAt        time.Time
	StartSoCPct    float64
	EndSoCPct      float64
	EnergyAddedKWh float64
	MilesAdded     float64
	MaxPowerKW     float64
	AvgPowerKW     float64
	FinalState     string
	Lat, Lon       float64
	Source         string
	Cost           float64
	Currency       string
	PricePerKWh    float64
	// ThermalKWh is the energy the BMS spent on pack heating / cooling
	// during the session, surfaced by Rivian's Parallax
	// ChargingSessionLiveData protobuf. Nullable: legacy rows
	// recorded before this column existed leave it nil so the UI
	// can render "—" instead of misleading "0 kWh thermal".
	ThermalKWh *float64
	// ChargeLimitPct is the charge limit the truck was set to during the session
	// (the last reported value, 1 to 100); nil when unknown. A later save that carries
	// none keeps the stored one.
	ChargeLimitPct *float64
	// PlaceOverride is the user's own "home" or "away" for this charge (empty: automatic). When
	// set, Place holds the same value and nothing re-classifies the row.
	PlaceOverride string
	// LocationOverride is "recorded" when the user says the charge happened where the truck was
	// (Lat/Lon), not at the nearest public charger; maps then never snap. Empty: as recorded.
	LocationOverride string
	// ActiveSeconds is the wall-clock time the session actually spent
	// charging (power above the idle floor), as opposed to
	// EndedAt-StartedAt which spans the whole plugged-in period
	// (including charging_ready / battery-conditioning idle). Zero on
	// legacy rows and non-live sources; the UI falls back to the wall
	// span in that case.
	ActiveSeconds float64
	// CostSource says where Cost came from: "rivian" (billed),
	// "home_rate", "network_estimate" (DCFC priced from the matched
	// network's rate), "observed_estimate" (DCFC priced from a typical
	// public price, no rate of the user's) or "user". Empty on legacy rows.
	CostSource string
	// Network is the matched DCFC network's display name for
	// network_estimate rows; empty otherwise.
	Network string
	// Place is where the session happened relative to the user's home
	// when it was recorded: "home", "away", or "" (unknown: no saved
	// home or no position). Migration 0044.
	Place string
	// NetworkState is DC fast charge auto-detection's verify state
	// (migration 0051): "estimated", "needs_confirmation", "confirmed",
	// or "" (not auto-detected: AC, Rivian-billed, user-priced, legacy).
	NetworkState string
	// NetworkConfidence is the detection's confidence, 0..1; nil when
	// there was no detection.
	NetworkConfidence *float64
	// NetworkEvidence is what the detection saw (JSON, contract v1);
	// nil when there was no detection.
	NetworkEvidence json.RawMessage
	// RivianCharger is Rivian's isRivianCharger for the session: nil
	// when not reported. Written by the live recorder; a later upsert
	// without it keeps the stored value. Not read back yet. Migration
	// 0050.
	RivianCharger *bool
	// ReceiptCost is what Rivian billed for the session (its Charging
	// history receipt), kept next to Cost (our estimate), which a receipt
	// never overwrites. Nil when no receipt matched. ReceiptCurrency and
	// ReceiptTxnID go with it. Migration 0055; written only by the
	// receipts sync.
	ReceiptCost     *float64
	ReceiptCurrency string
	ReceiptTxnID    string
	// EstimateMonth and EstimateURL say which public report priced a
	// CostSource "observed_estimate" session ("2026-10", the dcfctracker.com
	// page). Empty on every other row. Migration 0075.
	EstimateMonth string
	EstimateURL   string
	// EnergyEstimated says EnergyAddedKWh was not metered: the recorder's integral had lost energy (a handoff or a
	// restart took it) and the energy was estimated from the SoC gain. Stored in metadata ("energy_estimated"), set
	// and never cleared by an upsert (a row read back and re-saved keeps it).
	EnergyEstimated bool
	// GapKWh is the part of EnergyAddedKWh credited for stretches the recorder had no power frames for (a dropout
	// longer than its integration cap) from the SoC the pack gained across them, not metered. 0 when none. Stored
	// in metadata ("gap_kwh"); an upsert with 0 leaves a stored value alone.
	GapKWh float64
}

type ChartCharge struct {
	StartedAt   time.Time `json:"started_at"`
	EndedAt     time.Time `json:"ended_at"`
	StartSoCPct float64   `json:"start_soc_pct"`
	EndSoCPct   float64   `json:"end_soc_pct"`
	// ChargeLimitPct is the limit the truck was set to for the charge (1 to 100),
	// null when unknown (older charges are backfilled where the samples still exist).
	ChargeLimitPct *float64 `json:"charge_limit_pct"`
}

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

type LiveOverlap struct {
	EndedAt   time.Time
	EndSoCPct float64
	EnergyKWh float64
}

type RestampOptions struct {
	HomeLat, HomeLon float64
	RadiusM          float64
	// HomeRate and Currency price AC charges that become home and are
	// unpriced; HomeRate <= 0 prices nothing.
	HomeRate float64
	Currency string
	// IsDCFC is the shared fast-charging rule (rivian.IsDCFCSession);
	// fast charges are never priced at the home rate. nil treats every
	// session as AC.
	IsDCFC func(peakKW, energyKWh, activeSeconds float64, span time.Duration) bool
	DryRun bool
}

type RestampResult struct {
	DryRun            bool `json:"dry_run"`
	Changed           int  `json:"changed"`
	ToHome            int  `json:"to_home"`
	ToAway            int  `json:"to_away"`
	Unchanged         int  `json:"unchanged"`
	SkippedUserPriced int  `json:"skipped_user_priced"`
	// SkippedOverridden: charges whose home/away the user set by hand, never re-checked.
	SkippedOverridden    int        `json:"skipped_overridden"`
	WouldPriceAtHomeRate int        `json:"would_price_at_home_rate"`
	TotalCostDelta       float64    `json:"total_cost_delta"`
	Currency             string     `json:"currency"`
	RestampID            *uuid.UUID `json:"restamp_id"`
}

type StaleOpenCandidate struct {
	ExternalID      string
	RivianVehicleID string
	FinalState      string
	EndedAt         time.Time
}

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

type UndoResult struct {
	RestampID     uuid.UUID `json:"restamp_id"`
	RestoredPlace int       `json:"restored_place"`
	Unpriced      int       `json:"unpriced"`
}

type VerifiedNetwork struct {
	Network string
	DistM   float64
}