mirror of
https://github.com/MeshCore-Beacon/beacon-server.git
synced 2026-10-16 05:10:01 +00:00
MrAlders0n
98006a9364
Stats endpoints read hourly rollup tables filled once per closed hour by one advisory-locked task, instead of materialized views that re-scanned every observation on each refresh. IATA-set tables give exact distinct counts for any IATA set or region. Cleanup holds raw rows for unrolled hours (up to 24h). Adds /stats/series; ingest keeps packet observation counts, observer last IATA, channel message counts and trace tag summaries. 001_baseline.sql is rewritten, so pre-release 2.0 databases must be recreated. See docs/historical-stats.md.
106 lines
4.0 KiB
Go
106 lines
4.0 KiB
Go
// Copyright 2026 Beacon Contributors
|
|
// SPDX-License-Identifier: AGPL-3.0-or-later
|
|
|
|
package api
|
|
|
|
import (
|
|
"errors"
|
|
"fmt"
|
|
"strconv"
|
|
"strings"
|
|
"time"
|
|
)
|
|
|
|
// ChannelPage adds a precise cursor while retaining the numeric cursor for older clients.
|
|
type ChannelPage struct {
|
|
Page[ChannelSummary]
|
|
NextPageCursor *string `json:"nextPageCursor,omitempty"`
|
|
}
|
|
|
|
// ChannelCursor identifies a boundary in (last_seen DESC, id DESC) order.
|
|
type ChannelCursor struct {
|
|
LastSeen time.Time
|
|
ID int32
|
|
}
|
|
|
|
func (c ChannelCursor) String() string {
|
|
return fmt.Sprintf("v1:%d:%d", c.LastSeen.UnixMicro(), c.ID)
|
|
}
|
|
|
|
var errChannelCursor = errors.New("invalid channel page cursor")
|
|
|
|
// ParseChannelCursor parses the opaque, versioned cursor returned by ChannelPage.
|
|
func ParseChannelCursor(raw string) (*ChannelCursor, error) {
|
|
if len(raw) > 64 {
|
|
return nil, errChannelCursor
|
|
}
|
|
parts := strings.Split(raw, ":")
|
|
if len(parts) != 3 || parts[0] != "v1" {
|
|
return nil, errChannelCursor
|
|
}
|
|
micros, err := strconv.ParseInt(parts[1], 10, 64)
|
|
if err != nil {
|
|
return nil, errChannelCursor
|
|
}
|
|
id, err := strconv.ParseInt(parts[2], 10, 32)
|
|
if err != nil || id <= 0 {
|
|
return nil, errChannelCursor
|
|
}
|
|
at := time.UnixMicro(micros).UTC()
|
|
if at.Year() < 1 || at.Year() > 9999 {
|
|
return nil, errChannelCursor
|
|
}
|
|
return &ChannelCursor{LastSeen: at, ID: int32(id)}, nil
|
|
}
|
|
|
|
// ChannelMessage represents a single decrypted channel message.
|
|
// Only messages for channels with a known key are stored and returned.
|
|
type ChannelMessage struct {
|
|
ID int64 `json:"id"`
|
|
PacketHash string `json:"packetHash"` // hex-encoded packet hash for correlation with packet events
|
|
ChannelHash string `json:"channelHash"` // hex-encoded single-byte channel hash
|
|
SenderName string `json:"senderName"` // display name from the decrypted payload
|
|
Content string `json:"content"` // decrypted message text
|
|
SentAt int64 `json:"sentAt"` // epoch ms, from the sender's embedded timestamp
|
|
ObservationCount int64 `json:"observationCount"` // number of packet_observations rows for this message's packet hash
|
|
Scope *string `json:"scope"` // matched scope on the first stored packet; null when none was recorded
|
|
ScopeStatus ChannelScopeStatus `json:"scopeStatus" enums:"matched,unscoped,unknown,unavailable"`
|
|
}
|
|
|
|
// ChannelScopeStatus describes stored packet evidence, not a channel key or all reception paths.
|
|
type ChannelScopeStatus string
|
|
|
|
// RecordedChannelScopeStatus preserves missing capture metadata as unavailable.
|
|
func RecordedChannelScopeStatus(name *string, transport *bool) ChannelScopeStatus {
|
|
if name != nil {
|
|
return "matched"
|
|
}
|
|
if transport == nil {
|
|
return "unavailable"
|
|
}
|
|
if *transport {
|
|
return "unknown"
|
|
}
|
|
return "unscoped"
|
|
}
|
|
|
|
// ChannelSummary is the minimal channel representation used in list responses.
|
|
type ChannelSummary struct {
|
|
ID int `json:"id"`
|
|
Name *string `json:"name,omitempty"` // display name from config or nil
|
|
ChannelHash string `json:"channelHash"` // hex-encoded single-byte hash
|
|
LastSeen int64 `json:"lastSeen"` // epoch ms, time of most recent message
|
|
IsHashtag bool `json:"isHashtag"` // true if key was derived from a hashtag PSK
|
|
KeyKnown bool `json:"keyKnown"` // true if Beacon has a decryption key for this channel
|
|
}
|
|
|
|
// Channel is the full channel representation including decryption metadata.
|
|
// KeyFingerprint is only populated for hashtag channels since their keys are
|
|
// publicly derivable from the tag name.
|
|
type Channel struct {
|
|
ChannelSummary
|
|
Hashtag *string `json:"hashtag,omitempty"` // tag name without # prefix; non-nil only for hashtag channels
|
|
KeyFingerprint *string `json:"keyFingerprint,omitempty"` // first 8 bytes of SHA256(key), hex-encoded
|
|
MessageCount int64 `json:"messageCount"` // lifetime count; not reduced by retention
|
|
}
|