domain

type AcceptedTraffic struct {
	EdgeID     string
	SourceID   string
	TargetID   string
	ObserverID string
	AToBBytes  int64
	BToABytes  int64
	ReceivedAt time.Time
}

type EdgeHistory struct {
	EdgeID              string               `json:"edgeId"`
	Source              HistoryNodeReference `json:"source"`
	Target              HistoryNodeReference `json:"target"`
	From                time.Time            `json:"from"`
	To                  time.Time            `json:"to"`
	BucketDurationMS    int64                `json:"bucketDurationMs"`
	Traffic             []TrafficBucket      `json:"traffic"`
	PathAnchor          *PathEvent           `json:"pathAnchor,omitempty"`
	PathEvents          []PathEvent          `json:"pathEvents"`
	TrafficTruncated    bool                 `json:"trafficTruncated"`
	PathEventsTruncated bool                 `json:"pathEventsTruncated"`
}

type EdgeState string

type HistoryEdgePage struct {
	Edges      []HistoryEdgeSummary `json:"edges"`
	NextCursor string               `json:"nextCursor,omitempty"`
}

type HistoryEdgeQuery struct {
	Window HistoryWindow
	NodeID string
	Path   PathKind
	Cursor string
	Limit  int
}

type HistoryEdgeSummary struct {
	EdgeID        string               `json:"edgeId"`
	Source        HistoryNodeReference `json:"source"`
	Target        HistoryNodeReference `json:"target"`
	LastTrafficAt time.Time            `json:"lastTrafficAt"`
	AToBBytes     int64                `json:"aToBBytes"`
	BToABytes     int64                `json:"bToABytes"`
	Paths         []PathKind           `json:"paths"`
}

type HistoryMetadata struct {
	Nodes     []TopologyNode
	Redirects map[string]string
}

type HistoryNodeReference struct {
	ID       string `json:"id"`
	Label    string `json:"label"`
	Hostname string `json:"hostname,omitempty"`
	DNSName  string `json:"dnsName,omitempty"`
	OS       string `json:"os,omitempty"`
}

type HistoryNodes struct {
	Nodes []HistoryNodeReference `json:"nodes"`
}

type HistoryWindow string

type NodeIdentity struct {
	StableNodeID string   `json:"stableNodeId"`
	NodeID       string   `json:"nodeId,omitempty"`
	NodeKey      string   `json:"nodeKey,omitempty"`
	DiscoKey     string   `json:"discoKey,omitempty"`
	Hostname     string   `json:"hostname"`
	DNSName      string   `json:"dnsName,omitempty"`
	OS           string   `json:"os,omitempty"`
	TailscaleIPs []string `json:"tailscaleIps,omitempty"`
}

type ObservationProvenance struct {
	ObserverID  string          `json:"observerId"`
	Path        PathObservation `json:"path"`
	CollectedAt time.Time       `json:"collectedAt"`
	ReceivedAt  time.Time       `json:"receivedAt"`
	ClockSkewed bool            `json:"clockSkewed"`
}

type ObserverReport struct {
	Observer            NodeIdentity      `json:"observer"`
	InventoryGeneration string            `json:"inventoryGeneration"`
	Peers               []PeerObservation `json:"peers,omitempty"`
}

type ObserverState struct {
	ID              string    `json:"id"`
	Hostname        string    `json:"hostname"`
	Online          bool      `json:"online"`
	LastSeen        time.Time `json:"lastSeen"`
	LastCollectedAt time.Time `json:"lastCollectedAt"`
	ClockSkewMS     int64     `json:"clockSkewMs"`
	ClockSkewed     bool      `json:"clockSkewed"`
}

type PathEvent struct {
	ObservedAt   time.Time               `json:"observedAt"`
	Path         PathObservation         `json:"path"`
	Observations []ObservationProvenance `json:"observations"`
}

type PathKind string

type PathObservation struct {
	Kind                  PathKind `json:"kind"`
	DirectEndpoint        string   `json:"directEndpoint,omitempty"`
	DERPRegion            string   `json:"derpRegion,omitempty"`
	PeerRelayStableNodeID string   `json:"peerRelayStableNodeId,omitempty"`
}

type PathTransition struct {
	EdgeID       string
	ObservedAt   time.Time
	Path         PathObservation
	Observations []ObservationProvenance
}

type PeerObservation struct {
	Peer             NodeIdentity    `json:"peer"`
	RxBytes          int64           `json:"rxBytes"`
	TxBytes          int64           `json:"txBytes"`
	RxDelta          int64           `json:"rxDelta"`
	TxDelta          int64           `json:"txDelta"`
	SampleDurationMS int64           `json:"sampleDurationMs"`
	Path             PathObservation `json:"path"`
	LastActive       time.Time       `json:"lastActive"`
}

type RelaySessionObservation struct {
	Relay               NodeIdentity `json:"relay"`
	Source              NodeIdentity `json:"source"`
	Target              NodeIdentity `json:"target"`
	SessionID           string       `json:"sessionId"`
	VNI                 int64        `json:"vni"`
	SourceEndpoint      string       `json:"sourceEndpoint,omitempty"`
	TargetEndpoint      string       `json:"targetEndpoint,omitempty"`
	SourceToTargetBytes int64        `json:"sourceToTargetBytes"`
	TargetToSourceBytes int64        `json:"targetToSourceBytes"`
	SourceToTargetDelta int64        `json:"sourceToTargetDelta"`
	TargetToSourceDelta int64        `json:"targetToSourceDelta"`
	SampleDurationMS    int64        `json:"sampleDurationMs"`
	LastActive          time.Time    `json:"lastActive"`
}

type ReportEnvelope struct {
	Version            int                       `json:"version"`
	ReportID           string                    `json:"reportId"`
	ReporterInstanceID string                    `json:"reporterInstanceId"`
	Sequence           int64                     `json:"sequence"`
	CollectedAt        time.Time                 `json:"collectedAt"`
	Kind               ReportKind                `json:"kind"`
	Observers          []ObserverReport          `json:"observers,omitempty"`
	RelaySessions      []RelaySessionObservation `json:"relaySessions,omitempty"`
}

type ReportKind string

type ReportReceipt struct {
	Accepted             bool     `json:"accepted"`
	ResyncRequired       bool     `json:"resyncRequired"`
	ControlStableNodeIDs []string `json:"controlStableNodeIds"`
	HeartbeatIntervalMS  int64    `json:"heartbeatIntervalMs"`
}

type Topology struct {
	GeneratedAt  time.Time       `json:"generatedAt"`
	NextChangeAt *time.Time      `json:"nextChangeAt,omitempty"`
	Nodes        []TopologyNode  `json:"nodes"`
	Edges        []TopologyEdge  `json:"edges"`
	Observers    []ObserverState `json:"observers"`
}

type TopologyEdge struct {
	ID                 string                  `json:"id"`
	Source             string                  `json:"source"`
	Target             string                  `json:"target"`
	Path               PathObservation         `json:"path"`
	State              EdgeState               `json:"state"`
	AToBBytesPerSecond float64                 `json:"aToBBytesPerSecond"`
	BToABytesPerSecond float64                 `json:"bToABytesPerSecond"`
	LastActive         time.Time               `json:"lastActive"`
	Observations       []ObservationProvenance `json:"observations"`
	Conflicts          []PathObservation       `json:"conflicts,omitempty"`
}

type TopologyNode struct {
	NodeIdentity
	ID             string    `json:"id"`
	Observable     bool      `json:"observable"`
	Online         bool      `json:"online"`
	LastEvidenceAt time.Time `json:"lastEvidenceAt"`
	ClockSkewed    bool      `json:"clockSkewed"`
}

type TrafficBucket struct {
	BucketStart time.Time `json:"bucketStart"`
	AToBBytes   int64     `json:"aToBBytes"`
	BToABytes   int64     `json:"bToABytes"`
}