storage

type AISMessage struct {
	ID         int64     `json:"id"`
	ReceivedAt time.Time `json:"received_at"`
	MMSI       uint32    `json:"mmsi"`
	Type       string    `json:"type"`
	Body       string    `json:"body"`

	// Position fields — populated when the message carries lat/lon.
	Latitude         float64 `json:"latitude,omitempty"`
	Longitude        float64 `json:"longitude,omitempty"`
	SpeedOverGround  float64 `json:"sog,omitempty"`
	CourseOverGround float64 `json:"cog,omitempty"`
	Heading          int     `json:"heading,omitempty"`
	HasPosition      bool    `json:"has_position"`

	// Static-data fields — populated for types 5 and 24.
	VesselName  string `json:"vessel_name,omitempty"`
	Callsign    string `json:"callsign,omitempty"`
	Destination string `json:"destination,omitempty"`
	ShipType    int    `json:"ship_type,omitempty"`
	IMO         uint32 `json:"imo,omitempty"`

	// RawHex is the wire-bit payload as hex for round-tripping into
	// offline decoders / debugging unrecognised message types.
	RawHex string `json:"raw_hex"`
	FCSOK  bool   `json:"fcs_ok"`
}

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

type APRSPacket struct {
	ID         int64     `json:"id"`
	ReceivedAt time.Time `json:"received_at"`
	Src        string    `json:"src"`
	Dst        string    `json:"dst"`
	Path       string    `json:"path"`
	Type       string    `json:"type"`
	Body       string    `json:"body"`
	Latitude   float64   `json:"latitude,omitempty"`
	Longitude  float64   `json:"longitude,omitempty"`
	RawInfo    string    `json:"raw_info"`
	FCSOK      bool      `json:"fcs_ok"`
}

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

type AircraftReport struct {
	ID         int64     `json:"id"`
	ReceivedAt time.Time `json:"received_at"`

	// 24-bit ICAO aircraft address — rendered as a 6-char hex
	// string in the JSON ("4840D6") for readability while staying
	// integer in the SQL column for index efficiency.
	ICAO     uint32 `json:"icao"`
	ICAOHex  string `json:"icao_hex"`
	Kind     string `json:"kind"` // "ident" | "airborne-pos" | "velocity" | ...
	Body     string `json:"body"` // kind-specific summary
	CRCValid bool   `json:"crc_valid"`

	// Identification fields (KindIdentification).
	Callsign string `json:"callsign,omitempty"`
	Category int    `json:"category,omitempty"`

	// Position fields (KindAirbornePosition / KindSurfacePosition).
	// Surfaces the globally-decoded lat/lon when the per-ICAO
	// CPR pairing succeeded; HasPosition distinguishes that from
	// "raw CPR fields preserved but no global decode".
	Latitude    float64 `json:"latitude,omitempty"`
	Longitude   float64 `json:"longitude,omitempty"`
	Altitude    int     `json:"altitude_ft,omitempty"`
	HasPosition bool    `json:"has_position"`
	HasAltitude bool    `json:"has_altitude"`

	// Velocity fields (KindAirborneVelocity).
	GroundSpeedKn   int     `json:"ground_speed_kn,omitempty"`
	TrackDeg        float64 `json:"track_deg,omitempty"`
	VerticalRateFPM int     `json:"vertical_rate_fpm,omitempty"`

	// Raw 112-bit (or 56-bit) frame hex. Round-trips into raw_hex
	// for debugging frames the parser doesn't fully decode.
	RawHex string `json:"raw_hex"`
}

type Bookmark struct {
	ID        int64     `json:"id"`
	Name      string    `json:"name"`
	FreqHz    uint32    `json:"freq_hz"`
	Mode      string    `json:"mode"` // "FM", "NFM", "AM", "USB", "LSB", "CW", "DMR", ...
	CTCSSHz   float64   `json:"ctcss_hz,omitempty"`
	DCSCode   uint16    `json:"dcs_code,omitempty"`
	Notes     string    `json:"notes,omitempty"`
	Group     string    `json:"group,omitempty"` // operator-defined category
	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

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

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

type CallRow struct {
	ID          int64  `json:"id"`
	System      string `json:"system"`
	Protocol    string `json:"protocol"`
	GroupID     uint32 `json:"group_id"`
	SourceID    uint32 `json:"source_id"`
	FrequencyHz uint32 `json:"frequency_hz"`
	Encrypted   bool   `json:"encrypted"`
	AlgorithmID uint8  `json:"algorithm_id"`
	KeyID       uint16 `json:"key_id"`
	Emergency   bool   `json:"emergency"`
	DataCall    bool   `json:"data_call"`
	// Individual is true for a unit-to-unit / private call, where GroupID is a
	// target radio address rather than a talkgroup. Omitted for group calls.
	Individual bool `json:"individual,omitempty"`
	// Timeslot is the 1-based DMR TDMA slot (0 = n/a, 1 = TS1, 2 = TS2).
	Timeslot uint8 `json:"timeslot,omitempty"`
	// Priority is the call's on-air signalled priority (service-options low
	// 3 bits, 0 = none/lowest). Distinct from a talkgroup's configured priority.
	Priority       uint8     `json:"priority,omitempty"`
	DeviceSerial   string    `json:"device_serial"`
	StartedAt      time.Time `json:"started_at"`
	EndedAt        time.Time `json:"ended_at,omitempty"` // zero if call still active
	DurationMs     int64     `json:"duration_ms,omitempty"`
	EndReason      string    `json:"end_reason,omitempty"`
	TalkgroupAlpha string    `json:"talkgroup_alpha,omitempty"`
	// SourceAlpha is the resolved alias/name of the source radio (RID), from
	// the operator RID catalogue + live-decoded talker aliases; "" when
	// unresolved.
	SourceAlpha string `json:"source_alpha,omitempty"`
	// SignalDbFS is the call's mean received channel power in dBFS
	// (channel power, not calibrated RSSI or SNR). nil when unmeasured.
	SignalDbFS *float64 `json:"signal_dbfs,omitempty"`
	// EVMPct / SNRDb are the call's demod quality — RMS error-vector
	// magnitude (%) and estimated symbol SNR (dB). nil when unmeasured
	// (only P25 Phase 1 chains measure them). These ARE the demod-quality
	// figures to compare against another decoder, unlike SignalDbFS.
	EVMPct *float64 `json:"evm_pct,omitempty"`
	SNRDb  *float64 `json:"snr_db,omitempty"`
	// HasRecording is true when a finished recording is on disk for this call
	// (recording_path is set). The path itself is deliberately not serialised —
	// the UI plays via GET /api/v1/calls/{id}/audio, not a filesystem path.
	HasRecording bool `json:"has_recording,omitempty"`
}

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

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

type DSCMessage struct {
	ID         int64     `json:"id"`
	ReceivedAt time.Time `json:"received_at"`
	Format     string    `json:"format"`   // "distress" | "all-ships" | "individual" | "group" | ...
	Category   string    `json:"category"` // "distress" | "urgency" | "safety" | "routine"
	SelfMMSI   uint64    `json:"self_mmsi"`
	TargetMMSI uint64    `json:"target_mmsi,omitempty"`
	Nature     string    `json:"nature,omitempty"`   // distress nature ("fire", "sinking", ...)
	TimeUTC    string    `json:"time_utc,omitempty"` // HH:MM, distress only

	// Position fields — populated only on distress alerts that
	// included a position field with a non-sentinel value.
	Latitude    float64 `json:"latitude,omitempty"`
	Longitude   float64 `json:"longitude,omitempty"`
	HasPosition bool    `json:"has_position"`

	Body   string `json:"body"`    // type-specific summary
	RawHex string `json:"raw_hex"` // hex-encoded 7-bit symbol stream
}

type HistoryFilter struct {
	System    string
	GroupID   uint32 // 0 = no filter (filters call_log.group_id)
	SourceID  uint32 // 0 = no filter (filters call_log.source_id — RID)
	Since     time.Time
	Until     time.Time
	Limit     int
	OnlyEnded bool
}

type Label struct {
	ID   int64     `json:"id"`
	Kind LabelKind `json:"kind"`
	// System scopes the label to one trunking system. Empty applies it
	// wherever the id is seen, which matches the daemon's single merged
	// catalogue.
	System   string `json:"system,omitempty"`
	TargetID uint32 `json:"target_id"`
	// Name is the RID alias or the talkgroup alpha tag.
	Name        string    `json:"name,omitempty"`
	Description string    `json:"description,omitempty"`
	Tag         string    `json:"tag,omitempty"`
	Group       string    `json:"group,omitempty"`
	Owner       string    `json:"owner,omitempty"` // radios only
	Icon        string    `json:"icon,omitempty"`
	CreatedAt   time.Time `json:"created_at"`
	UpdatedAt   time.Time `json:"updated_at"`
}

type LabelKind string

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

type LoRaFrame struct {
	ID          int64     `json:"id"`
	ReceivedAt  time.Time `json:"received_at"`
	FrequencyHz uint32    `json:"frequency_hz"` // sub-channel centre frequency
	SF          int       `json:"sf"`           // spreading factor 7..12
	CR          int       `json:"cr"`           // coding rate 1..4 (4/5..4/8)
	BandwidthHz int       `json:"bandwidth_hz"`
	RSSI        float64   `json:"rssi"`
	SNR         float64   `json:"snr"`
	CFOHz       float64   `json:"cfo_hz"`
	CRCOK       bool      `json:"crc_ok"`
	PayloadHex  string    `json:"payload_hex"` // de-whitened PHY payload

	// LoRaWAN MAC fields (populated when IsLoRaWAN is true).
	IsLoRaWAN bool   `json:"is_lorawan"`
	MType     string `json:"mtype"`     // e.g. "unconfirmed-up", "join-request"
	DevAddr   string `json:"dev_addr"`  // hex, network data frames
	FCnt      uint32 `json:"fcnt"`      // frame counter
	FPort     int    `json:"fport"`     // -1 when absent
	MICOK     bool   `json:"mic_ok"`    // MIC verified against a known key
	Decrypted bool   `json:"decrypted"` // FRMPayload was decrypted
	DecodedJS string `json:"decoded"`   // best-effort decoded payload summary
}

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

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

type LocationRow struct {
	ID         int64     `json:"id"`
	System     string    `json:"system"`
	Protocol   string    `json:"protocol"`
	RadioID    uint32    `json:"radio_id"`
	Talkgroup  uint32    `json:"talkgroup"`
	Latitude   float64   `json:"latitude"`
	Longitude  float64   `json:"longitude"`
	SpeedKnots float64   `json:"speed_knots"`
	HeadingDeg float64   `json:"heading_deg"`
	ReportedAt time.Time `json:"reported_at"`
}

type M17LinkSetup struct {
	ID         int64     `json:"id"`
	ReceivedAt time.Time `json:"received_at"`
	Src        string    `json:"src"`
	Dst        string    `json:"dst"`
	Mode       string    `json:"mode"` // "voice" | "data" | "voice+data" | "packet"
	CAN        uint8     `json:"can"`  // channel-access number
	Meta       string    `json:"meta"` // hex-encoded META block
	CRCOK      bool      `json:"crc_ok"`
	Body       string    `json:"body"` // display summary
}

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

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

type MDC1200Message struct {
	ID         int64     `json:"id"`
	ReceivedAt time.Time `json:"received_at"`
	Op         uint8     `json:"op"`
	Arg        uint8     `json:"arg"`
	UnitID     uint16    `json:"unit_id"`
	Operation  string    `json:"operation"` // "PTT ID" | "Emergency" | ... ("" if unknown)
	Body       string    `json:"body"`
	RawHex     string    `json:"raw_hex"`
	CRCOK      bool      `json:"crc_ok"`
}

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

type PagerMessage struct {
	ID         int64     `json:"id"`
	ReceivedAt time.Time `json:"received_at"`
	Protocol   string    `json:"protocol"` // "pocsag" | "flex"
	RIC        uint32    `json:"ric"`
	Func       uint8     `json:"func"` // 0..3 = A..D
	Encoding   string    `json:"encoding"`
	Body       string    `json:"body"`
	Corrected  int       `json:"corrected"`
}

type RIDSummary struct {
	SourceID uint32
	System   string // system of the most recent call
	Protocol string // protocol of the most recent call
	// LastTalkgroup is the group_id of the most recent GROUP call (individual=0)
	// this radio was heard on; 0 when the radio has only ever made individual /
	// unit-to-unit calls (whose group_id is a target radio, not a talkgroup).
	LastTalkgroup uint32
	CallCount     uint64
	FirstSeen     time.Time
	LastSeen      time.Time
	// SourceAlpha is the resolved alias from the most recent call, "" if none.
	SourceAlpha string
}

type RIDSummaryFilter struct {
	System   string // "" = all systems
	SourceID uint32 // 0 = all radios (filters call_log.source_id)
	Limit    int    // <= 0 = all radios
}

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

type RetentionOptions struct {
	DB *DB
	// FilesRoot is the directory the voice recorder writes WAV / raw
	// files under. Empty disables the filesystem sweep.
	FilesRoot string
	// CallRowMaxAge: call_log rows with started_at older than this are
	// deleted. Zero (the default) disables call-row deletion.
	CallRowMaxAge time.Duration
	// LogRowMaxAge: decoder log-table rows (pager_log, aprs_log,
	// vessel_log, dsc_log, aircraft_log, mdc1200_log, m17_log,
	// location_log) with received_at older than this are deleted. Zero
	// (the default) disables decoder-log deletion.
	LogRowMaxAge time.Duration
	// FilesMaxAge: files older than this (mtime) are deleted. Zero
	// disables file deletion.
	FilesMaxAge time.Duration
	// Interval between sweeps. Default 1 h.
	Interval time.Duration
	Log      *slog.Logger
}

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