stationcache

type BBox struct {
	SwLat, SwLon, NeLat, NeLon float64
}

type CacheEntry struct {
	Key      string
	IsObject bool
	Killed   bool // object/item with Live==false → delete from cache
	Callsign string
	// Source is the AX.25 source callsign that transmitted the packet —
	// the originating station of an object/item. Empty for ordinary
	// station packets, where Callsign already is the source.
	Source    string
	Lat, Lon  float64
	HasPos    bool
	Alt       float64
	HasAlt    bool
	Speed     float64
	Course    int
	HasCourse bool
	Symbol    [2]byte
	Via       string
	Path      []string
	Hops      int
	Direction string
	Gated     bool // arrived as the inner packet of an Internet-to-RF third-party gate
	Channel   uint32
	Comment   string
	Weather   *Weather
	Timestamp time.Time
}

type HeatPoint struct {
	Lat   float64
	Lon   float64
	Count int
}

type HeatmapResult struct {
	Points      []HeatPoint
	MaxCount    int
	Unlocatable int
}

type HistoryStore interface {
	WriteEntries(entries []CacheEntry) error
	LoadRecent(maxAge time.Duration, trailLimit int) (map[string]*Station, error)
	Prune(maxAge time.Duration) error
	QueryHeatmap(window time.Duration, bbox BBox) (*HeatmapResult, error)
	RecordRxEvent(ev RxEvent) error
	Close() error
}

type LatLon struct {
	Lat, Lon float64
}

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

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

type Position struct {
	Lat       float64
	Lon       float64
	Alt       float64
	HasAlt    bool
	Speed     float64 // knots
	Course    int
	HasCourse bool
	Via       string
	Path      []string
	Hops      int
	Direction string
	Gated     bool
	Channel   uint32
	Comment   string
	Timestamp time.Time
}

type RxEvent struct {
	Timestamp time.Time
	AttrKey   string
	Hops      int
	Lat       float64
	Lon       float64
	HasPos    bool
}

type Station struct {
	Key       string     // "stn:W1ABC-9" or "obj:SHELTER1"
	Callsign  string     // display name (callsign or object/item name)
	IsObject  bool       // true for APRS objects/items
	Source    string     // originating station callsign for objects/items; empty for regular stations
	Positions []Position // newest first; cap at MaxTrailLen. Static stations have len 1.
	Symbol    [2]byte    // [table, code]
	Via       string     // "rf" or "is"
	Path      []string   // digi path from AX.25 header
	Hops      int        // count of H-bit digi addresses
	Direction string     // "RX", "TX", "IS"
	Gated     bool       // Internet-to-RF gated (inner of a third-party packet)
	Channel   uint32
	Comment   string
	Weather   *Weather // nil if not a weather station
	LastHeard time.Time
	// LastDirectHeard is the timestamp of the most recent reception heard
	// directly on RF (RX, zero digi hops). Set only by direct receptions and
	// never advanced by digipeated/gated/IS copies, so the Live Map "Direct
	// RX" filter can age a station out of the selected time window even when
	// the fix stays classified as direct for display (issues #130 + #349).
	// Zero value means the station has never been heard directly.
	LastDirectHeard time.Time
}

type StationStore interface {
	// QueryBBox returns stations within the bounding box heard within maxAge.
	// Returned slice is a snapshot — caller owns it.
	QueryBBox(bbox BBox, maxAge time.Duration) []Station

	// Lookup returns positions for the given callsigns regardless of bbox.
	// Used for server-side digi path resolution. Missing callsigns omitted.
	Lookup(callsigns []string) map[string]LatLon
}

type Weather struct {
	Temp          float64
	HasTemp       bool
	WindSpeed     float64
	HasWindSpeed  bool
	WindDir       int
	HasWindDir    bool
	WindGust      float64
	HasWindGust   bool
	Humidity      int
	HasHumidity   bool
	Pressure      float64
	HasPressure   bool
	Rain1h        float64
	HasRain1h     bool
	Rain24h       float64
	HasRain24h    bool
	Snow24h       float64
	HasSnow24h    bool
	Luminosity    int
	HasLuminosity bool
}