aprs

type Capabilities struct {
	Entries map[string]string // key → value (value empty for flag entries)
}

type DecodedAPRSPacket struct {
	Raw           []byte // original AX.25 frame bytes
	Source        string // callsign-SSID
	Dest          string
	Path          []string
	Type          PacketType
	Position      *Position
	Message       *Message
	Weather       *Weather
	Telemetry     *Telemetry
	Object        *Object
	Item          *Item
	MicE          *MicE
	Caps          *Capabilities
	DF            *DirectionFinding
	TelemetryMeta *TelemetryMeta     // PARM/UNIT/EQNS/BITS metadata (APRS101 ch 13)
	ThirdParty    *DecodedAPRSPacket // recursively-decoded inner packet for '}' traffic (APRS101 ch 20)
	Status        string             // for '>' status reports
	Comment       string             // residual free-form text after structured fields
	Timestamp     time.Time
	Channel       int
	Quality       int // modem-reported quality (0..100) if available
	// Direction identifies the ingress path: DirectionRF for packets heard
	// over RF via the modem bridge / KISS / AGW, DirectionIS for packets
	// received from APRS-IS by the iGate. Unset (DirectionUnknown) when
	// the packet is synthesized (e.g. inner third-party decode, tests) or
	// constructed before ingress provenance is known.
	Direction Direction
}

type DeviceInfo struct {
	Vendor string `json:"vendor,omitempty"`
	Model  string `json:"model,omitempty"`
	Class  string `json:"class,omitempty"`
}

type Direction string

type DirectionFinding struct {
	Bearing int // degrees true
	Number  int // 0..9 station count
	Range   int // miles
	Quality int // 0..9
}

type InboundPacket struct {
	Raw     []byte
	Source  string
	Channel int
}

type Item struct {
	Name     string
	Live     bool
	Position *Position
	Comment  string
}

type LogOutput struct {
	Logger *slog.Logger
}

type Message struct {
	Addressee   string // 1..9 chars, space-padded in packet
	Text        string
	MessageID   string // optional identifier used for ACK/REJ correlation
	ReplyAck    string // piggybacked reply-ack id (aprs11/replyacks), empty if absent
	HasReplyAck bool   // true if a reply-ack trailer was present (ack may still be "")
	IsAck       bool
	IsRej       bool
	IsBulletin  bool // addressee starts with BLN
	IsNWS       bool // NWS-originated
}

type MicE struct {
	Position     Position
	MessageCode  int // 0..7 index into the standard Mic-E message table
	MessageText  string
	Manufacturer string // e.g. "Kenwood TH-D74", "" if unknown
	Status       string // trailing status text
}

type Object struct {
	Name      string
	Live      bool
	Timestamp *time.Time
	Position  *Position
	Comment   string
}

type PHG struct {
	Raw         string // four-digit "phgd" body (e.g. "7700"); never includes the "PHG" prefix
	PowerWatts  int    // p² watts
	HeightFt    int    // 10·2^h feet above average terrain
	GainDB      int    // g dB (0..9)
	Directivity int    // 0=omni, 1..8 = 45°·d compass direction (N, NE, E, …)
}

type PacketInput interface {
	RecvPacket(ctx context.Context) (*InboundPacket, error)
	Close() error
}

type PacketOutput interface {
	SendPacket(ctx context.Context, pkt *DecodedAPRSPacket) error
	Close() error
}

type PacketType string

type Position struct {
	Latitude   float64 // decimal degrees, positive north
	Longitude  float64 // decimal degrees, positive east
	Ambiguity  int     // 0..4, digits of ambiguity introduced by spaces
	Altitude   float64 // meters (0 if none reported)
	HasAlt     bool
	Speed      float64 // knots
	Course     int     // degrees true (0..359)
	HasCourse  bool
	Symbol     Symbol
	Compressed bool
	Timestamp  *time.Time // nil if positionless or no embedded time
	LocalTime  bool       // true if the timestamp was the '/' local-time form (APRS101 ch 6)
	PHG        *PHG       // decoded Power/Height/Gain/Directivity extension (APRS101 ch 7), nil if not present
	DAODatum   byte       // DAO datum byte (APRS101 DAO extension), 0 if not present
}

type Symbol struct {
	Table byte
	Code  byte
}

type Telemetry struct {
	Seq        int // 0..999, -1 if absent
	Analog     [5]float64
	AnalogHas  [5]bool // true for channels actually reported (distinguishes 0 from missing)
	Digital    uint8   // bits 0..7 (only lower 8)
	HasDigital bool
	Comment    string // trailing free-form
}

type TelemetryMeta struct {
	Kind        string // "parm", "unit", "eqns", or "bits"
	Parm        [13]string
	Unit        [13]string
	Eqns        [5][3]float64 // a, b, c coefficients per analog channel
	Bits        uint8         // BITS. sense-bits bitmap (active-high per bit)
	ProjectName string        // BITS. project title
}

type Weather struct {
	WindDirection  int // degrees true
	HasWindDir     bool
	WindSpeed      float64 // mph (1-minute sustained)
	HasWindSpeed   bool
	WindGust       float64 // mph (5-minute peak)
	HasWindGust    bool
	Temperature    float64 // degrees F
	HasTemp        bool
	Rain1Hour      float64 // hundredths of an inch
	HasRain1h      bool
	Rain24Hour     float64
	HasRain24h     bool
	RainSinceMid   float64
	HasRainMid     bool
	Humidity       int // percent (0..100)
	HasHumidity    bool
	Pressure       float64 // tenths of millibar (e.g. 10132 = 1013.2)
	HasPressure    bool
	Luminosity     int // watts/m^2
	HasLuminosity  bool
	Snowfall24h    float64 // inches (via 's' after 'g')
	HasSnow        bool
	RawRainCounter int // raw rain counter ('#' field)
	HasRawRain     bool
	SoftwareType   string // one-letter software code (e.g. 'w', 'x', 'd')
	WeatherUnitTag string // 2..4 ASCII letters identifying the unit/model
}