webapi

type ActionsService interface {
	ReloadListeners(ctx context.Context) error
	TestFire(ctx context.Context, a *configstore.Action, args []actions.KeyValue) (actions.Result, uint)
}

type ChannelReferrersResponse struct {
	Error     string                 `json:"error,omitempty"`
	Referrers []configstore.Referrer `json:"referrers"`
}

type Config struct {
	Store         *configstore.Store
	Bridge        *modembridge.Bridge
	KissManager   *kiss.Manager
	KissCtx       context.Context // parent context for dynamically started KISS servers
	Logger        *slog.Logger
	HistoryDBPath string // path to history database, from -history-db flag
	Version       string // build-time version string reported by GET /api/version
	// MapsAuth is the registration client used by
	// POST /api/preferences/maps/register. Optional; NewServer
	// defaults to a client pointed at mapsauth.DefaultBaseURL when
	// nil so production wiring doesn't need to set it explicitly.
	// Tests inject a client pointed at an httptest.Server.
	MapsAuth *mapsauth.Client
	// MapsCache is the PMTiles download/cache manager. Optional —
	// the /api/maps/downloads handlers and ServeTilesPMTiles return
	// 503 when nil so wiring can defer construction until the cache
	// directory is known. Tests inject a Manager pointed at a temp
	// dir + httptest upstream.
	MapsCache *mapscache.Manager
	// Catalog is the download-catalog fetcher. Optional — the
	// /api/maps/catalog handler and slug-validation paths return 503
	// when nil. Tests inject a Cache pointed at an httptest upstream.
	Catalog *mapscatalog.Cache
}

type IgateSimulationResponse struct {
	SimulationMode bool `json:"simulation_mode"`
}

type IgateToggleRequest struct {
	Enabled bool `json:"enabled"`
}

type MessagesService interface {
	SendMessage(ctx context.Context, req messages.SendMessageRequest) (*configstore.Message, error)
	Resend(ctx context.Context, id uint64) (messages.SendResult, error)
	SoftDelete(ctx context.Context, id uint64) error
	SoftDeleteThread(ctx context.Context, kind, key string) (int, error)
	MarkRead(ctx context.Context, id uint64) error
	MarkUnread(ctx context.Context, id uint64) error
	ReloadTacticalCallsigns(ctx context.Context) error
	ReloadPreferences(ctx context.Context) error
	EventHub() *messages.EventHub
}

type MessagesStore interface {
	List(ctx context.Context, f messages.Filter) ([]configstore.Message, string, error)
	GetByID(ctx context.Context, id uint64) (*configstore.Message, error)
	ConversationRollup(ctx context.Context, limit int) ([]messages.ConversationSummary, error)
	ListParticipants(ctx context.Context, tacticalKey string, within time.Duration) ([]messages.Participant, time.Duration, error)
	QueryMessageHistoryByPeer(ctx context.Context, prefix string, limit int) ([]messages.MessageHistoryEntry, error)
}

type PositionDTO struct {
	Valid     bool    `json:"valid"`
	Source    string  `json:"source"` // "gps", "fixed", or "none"
	Latitude  float64 `json:"lat,omitempty"`
	Longitude float64 `json:"lon,omitempty"`
	Altitude  float64 `json:"alt_m,omitempty"`
	HasAlt    bool    `json:"has_alt,omitempty"`
	Speed     float64 `json:"speed_kt,omitempty"`
	Heading   float64 `json:"heading_deg,omitempty"`
	HasCourse bool    `json:"has_course,omitempty"`
	Timestamp string  `json:"timestamp,omitempty"`
}

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

type StationCache interface {
	stationcache.StationStore
	Gen() uint64
}

type StationDTO struct {
	// Callsign is the station or object name (APRS callsign-SSID for stations, object/item name otherwise).
	Callsign string `json:"callsign"`
	// IsObject is true for APRS objects and items; false for regular stations.
	IsObject bool `json:"is_object,omitempty"`
	// SymbolTable is the APRS symbol table character ("/" primary, "\\" alternate, or an overlay char).
	SymbolTable string `json:"symbol_table"`
	// SymbolCode is the APRS symbol code character within the selected table.
	SymbolCode string `json:"symbol_code"`
	// Positions is the station's position history, newest first; static stations have exactly one entry.
	Positions []StationPosDTO `json:"positions"`
	// LastHeard is the UTC RFC3339 timestamp of the most recent packet from this station.
	LastHeard time.Time `json:"last_heard"`
	// Direction indicates the source of the most recent packet: "RX" (heard on air), "TX" (sent by us), or "IS" (APRS-IS).
	Direction string `json:"direction"`
	// Via is the callsign of the last digipeater in the most recent packet's H-bit path; empty for direct packets.
	Via string `json:"via,omitempty"`
	// Path is the raw AX.25 digipeater path from the most recent packet (entries with trailing "*" have the H-bit set).
	Path []string `json:"path,omitempty"`
	// PathPositions lists [lat, lon] pairs resolved for H-bit digipeaters in Path; zero pair when position is unknown.
	PathPositions [][2]float64 `json:"path_positions,omitempty"`
	// Hops is the APRS digipeater hop count (number of H-bit entries in Path).
	Hops int `json:"hops,omitempty"`
	// Channel is the graywolf channel ID that received the most recent packet.
	Channel uint32 `json:"channel"`
	// Comment is the free-form comment field from the most recent packet.
	Comment string `json:"comment"`
	// Weather is optional weather telemetry; present only when include=weather is requested and the station reports weather.
	Weather *WeatherDTO `json:"weather,omitempty"`
}

type StationPosDTO struct {
	// Lat is the reported latitude in decimal degrees (WGS84, north positive).
	Lat float64 `json:"lat"`
	// Lon is the reported longitude in decimal degrees (WGS84, east positive).
	Lon float64 `json:"lon"`
	// Alt is the reported altitude in meters above mean sea level; omitted when not reported.
	Alt float64 `json:"alt_m,omitempty"`
	// HasAlt is true when the originating packet reported an altitude.
	HasAlt bool `json:"has_alt,omitempty"`
	// Speed is the reported ground speed in knots; omitted when not reported.
	Speed float64 `json:"speed_kt,omitempty"`
	// Course is the reported course over ground in degrees true (0-359); omitted when not reported.
	Course *int `json:"course,omitempty"`
	// Via is the callsign of the last digipeater (H-bit) that forwarded this position packet; empty for direct.
	Via string `json:"via,omitempty"`
	// Path is the AX.25 digipeater path recorded with this position fix.
	Path []string `json:"path,omitempty"`
	// PathPositions lists [lat, lon] pairs resolved for H-bit digipeaters in Path; zero pair when position is unknown.
	PathPositions [][2]float64 `json:"path_positions,omitempty"`
	// Hops is the APRS digipeater hop count (number of H-bit entries in Path) for this fix.
	Hops int `json:"hops,omitempty"`
	// Direction indicates the source of this position packet: "RX", "TX", or "IS".
	Direction string `json:"direction,omitempty"`
	// Channel is the graywolf channel ID that received this position packet.
	Channel uint32 `json:"channel,omitempty"`
	// Comment is the free-form comment field from this position packet.
	Comment string `json:"comment,omitempty"`
	// Timestamp is the UTC RFC3339 time the position was received.
	Timestamp time.Time `json:"timestamp"`
}

type StatusChannel struct {
	ID             uint32  `json:"id"`
	Name           string  `json:"name"`
	ModemType      string  `json:"modem_type"`
	BitRate        uint32  `json:"bit_rate"`
	RxFrames       uint64  `json:"rx_frames"`
	RxBadFCS       uint64  `json:"rx_bad_fcs"`
	TxFrames       uint64  `json:"tx_frames"`
	DcdState       bool    `json:"dcd_state"`
	AudioPeak      float32 `json:"audio_peak"`
	InputDeviceID  uint32  `json:"input_device_id"`
	DevicePeakDBFS float32 `json:"device_peak_dbfs"`
	DeviceRmsDBFS  float32 `json:"device_rms_dbfs"`
	DeviceClipping bool    `json:"device_clipping"`
}

type StatusDTO struct {
	// UptimeSeconds is the server process uptime in whole seconds.
	UptimeSeconds int64 `json:"uptime_seconds"`
	// Channels is the per-channel live status snapshot (frame counters, audio levels).
	Channels []StatusChannel `json:"channels"`
	// Igate is the current iGate session state; omitted when no iGate is configured.
	Igate *StatusIgateDTO `json:"igate,omitempty"`
}

type StatusIgateDTO struct {
	// Connected is true while an APRS-IS session is established.
	Connected bool `json:"connected"`
	// Server is the APRS-IS host:port currently in use (or last attempted).
	Server string `json:"server"`
	// Callsign is the login callsign-SSID presented to APRS-IS.
	Callsign string `json:"callsign"`
	// SimulationMode is true when RF->IS uploads are suppressed for testing.
	SimulationMode bool `json:"simulation_mode"`
	// LastConnected is the UTC RFC3339 timestamp of the most recent successful IS login; omitted if never connected.
	LastConnected time.Time `json:"last_connected,omitempty"`
	// Gated is the cumulative count of RF packets forwarded to APRS-IS.
	Gated uint64 `json:"rf_to_is_gated"`
	// Downlinked is the cumulative count of IS packets transmitted on RF.
	Downlinked uint64 `json:"is_to_rf_gated"`
	// Filtered is the cumulative count of packets dropped by the filter engine.
	Filtered uint64 `json:"packets_filtered"`
	// DroppedOffline is the cumulative count of RF packets dropped because the IS session was offline.
	DroppedOffline uint64 `json:"rf_to_is_dropped"`
}

type VersionResponse struct {
	Version string `json:"version"`
	// Platform is runtime.GOOS of the server process — "windows", "linux",
	// "darwin", etc. The UI uses it to surface platform-specific guidance
	// (e.g. the Windows app-volume warning on the Audio Devices page).
	Platform string `json:"platform"`
}

type WeatherDTO struct {
	// Temperature is the ambient temperature in degrees Fahrenheit; nil when not reported.
	Temperature *float64 `json:"temp_f,omitempty"`
	// WindSpeed is the sustained wind speed in miles per hour; nil when not reported.
	WindSpeed *float64 `json:"wind_mph,omitempty"`
	// WindDir is the wind direction in degrees true (0-359); nil when not reported.
	WindDir *int `json:"wind_dir,omitempty"`
	// WindGust is the peak wind gust in miles per hour; nil when not reported.
	WindGust *float64 `json:"gust_mph,omitempty"`
	// Humidity is the relative humidity in percent (0-100); nil when not reported.
	Humidity *int `json:"humidity,omitempty"`
	// Pressure is the barometric pressure in millibars; nil when not reported.
	Pressure *float64 `json:"pressure_mb,omitempty"`
	// Rain1h is rainfall in the last hour in inches; nil when not reported.
	Rain1h *float64 `json:"rain_1h_in,omitempty"`
	// Rain24h is rainfall in the last 24 hours in inches; nil when not reported.
	Rain24h *float64 `json:"rain_24h_in,omitempty"`
	// Snow24h is snowfall in the last 24 hours in inches; nil when not reported.
	Snow24h *float64 `json:"snow_24h_in,omitempty"`
	// Luminosity is solar radiation in watts per square meter; nil when not reported.
	Luminosity *int `json:"luminosity_wm2,omitempty"`
}