dcfcrates

type Candidate struct {
	Name       string  // station name
	Network    string  // the archive's network field (NREL ev_network, renamed)
	Operator   string  // the archive's operator field (often a URL)
	DistM      float64 // from the charge position
	MaxPowerKW float64 // 0 when unknown
}

type DetectInput struct {
	RivianCharger bool        // Rivian reported isRivianCharger for this DC session
	Site          *SiteMemory // nil when none within SiteMemoryRadiusM
	Candidates    []Candidate // DC stations within SiteRadiusM, any order
	PeakKW        float64     // the session's peak power, 0 when unknown
}

type Detection struct {
	Query      string
	Network    string // display name of the detected network ("" when none)
	State      string
	Confidence float64
	Evidence   json.RawMessage
}

type MembershipTerm struct {
	Slug      string // the network's slug in Networks
	Plan      string
	Terms     string // as the operator states it
	SourceURL string // the operator page
	// ReadVia says how the text was read: "page" (the operator's page was fetched) or
	// "search snippet" (the page itself could not be fetched; the text is what the
	// operator's own page showed in search results).
	ReadVia string
	Checked string // YYYY-MM-DD
}

type Network struct {
	Slug        string
	DisplayName string
	// MatchPatterns are substrings checked (case-insensitive) against
	// the charger name returned by Rivian's planTrip waypoint.
	// Order matters: more specific patterns must come first. The
	// Tesla / Tesla Supercharger pair is the canonical example -
	// "tesla supercharger" appears before "tesla" so destination
	// chargers don't accidentally claim the Supercharger rate.
	MatchPatterns []string
	GuestRate     float64
	// MemberRate is the rate after paying for the network's
	// subscription. Nil = no membership tier exists (ChargePoint,
	// Francis, etc.) or the user is automatically a member (RAN -
	// every Rivolt user is by definition a Rivian owner).
	MemberRate *float64
	// MemberPlan is the human-readable plan name + monthly cost
	// surfaced in the cost-strip tooltip later. Empty when no plan.
	MemberPlan string
	// RivianIDs are the values passed to Rivian's planTrip2
	// networkPreferences[].networkId field. Some networks span
	// multiple operator IDs (RAN = Adventure + Wayfinder; FLO =
	// FLOC + FLOU for Canada/US), so this is a list. Mapping of the
	// network ids Rivian reports:
	//
	//   10001, 10002 → RAN (Adventure + Wayfinder, "RAN, RWN")
	//   10025         → ChargePoint
	//   10027         → Electrify America
	//   10030         → EV Connect
	//   10031         → EVgo
	//   10032, 10033 → FLO ("FLOC, FLOU" — Canada + US)
	//   10045         → Shell Recharge
	//   10050         → Tesla
	//   10056         → IONNA
	//
	// Networks outside that enum (Blink, bp pulse, Francis Energy)
	// leave RivianIDs empty — Rivian's planner doesn't recognise
	// them, so sending an arbitrary ID would risk being treated as
	// "exclude everything else." Custom user-added rows also stay
	// empty.
	RivianIDs []string
	// DefaultMemberActive is the initial MemberActive state for a
	// freshly-seeded ChargingNetwork row. True for networks every
	// Rivolt user qualifies for by definition (RAN — every user
	// owns a Rivian). False for opt-in subscriptions (EA Pass+,
	// Tesla SC Membership, EVgo Plus).
	DefaultMemberActive bool
}

type NetworkOverride struct {
	Slug         string
	Name         string
	GuestRate    float64
	MemberRate   float64 // 0 = no member tier
	MemberActive bool
	MemberPlan   string
}

type ObservedPrice struct {
	Slug string
	// Low and High are USD per kWh (see the note above).
	Low, High float64
	// Month is the observation month, "2006-01" form (the month of the tracker report).
	Month string
	// URL is the tracker page the figure was copied from.
	URL string
	// Note says what Low and High are, for whoever re-checks the row.
	Note string
	// LowNote and HighNote say what each end is, for the UI, when Low and High differ.
	LowNote, HighNote string
}

type PinChoice struct {
	Snap  bool   `json:"snap"`
	Label string `json:"label"`
}

type PoiLike struct {
	Name       string  `json:"name,omitempty"`
	Operator   string  `json:"operator,omitempty"`
	Network    string  `json:"network,omitempty"`
	Brand      string  `json:"brand,omitempty"`
	MaxPowerKW float64 `json:"maxPowerKW,omitempty"`
}

type ResolvedRate struct {
	Slug          string
	DisplayName   string
	GuestRate     float64
	UserRate      float64 // honours the user's MemberActive toggle
	AllMemberRate float64 // hypothetical "you have every plan"
	MemberPlan    string
}

type ShownMembershipTerm struct {
	MembershipTerm
	Network string
	Label   string
}

type SiteMemory struct {
	Network string // display name as stored on that charge
	DistM   float64
}

type StopNetwork struct {
	Slug        string
	DisplayName string
	MemberPlan  string
	// UserPerKWh is what the user's saved price book says they pay (their active
	// membership applied), and ok only when it is THEIR number: a custom row, or a
	// built-in row whose rate differs from the built-in default. A row still holding
	// the default (the seed the Settings page offers) is the table figure, not theirs.
	UserPerKWh float64
	UserSet    bool
}