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"`
	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"`
}

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 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 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
}