digipeater

type Config struct {
	// MyCall is the per-digipeater callsign override. Empty string means
	// "inherit from StationCallsign". A non-empty value wins (e.g. a
	// mountaintop digi running under MTNTOP-1 distinct from the operator's
	// personal call). The resolved callsign is used for preemptive digi
	// (if a path slot equals it, the frame is repeated regardless of
	// WIDEn-N rules) and for TRACEn-N insertion.
	MyCall string

	// StationCallsign is the resolved station callsign fallback used when
	// MyCall is empty. The wiring layer resolves this once per
	// start/reload from StationConfig and hands it in; the digipeater
	// package does not read configstore directly.
	StationCallsign string

	// DedupeWindow is the time window within which an identical frame
	// will be dropped. Default 30s if zero.
	DedupeWindow time.Duration

	// Rules lists all digipeater rules (across all channels). The
	// engine filters by FromChannel on each call. The slice may be
	// replaced via SetRules for live reconfig.
	Rules []Rule

	// Submit is the TX sink. Required. Typically
	// func(ctx, ch, f, src) error { return gov.Submit(...) }.
	Submit func(ctx context.Context, channel uint32, frame *ax25.Frame, src txgovernor.SubmitSource) error

	// Logger is optional.
	Logger *slog.Logger

	// OnPacket is an optional hook invoked after a successful digipeat,
	// carrying a short human-readable note. Used by packetlog to
	// annotate entries.
	OnPacket func(note string, fromChan, toChan uint32, f *ax25.Frame)

	// OnDedup is an optional hook invoked when a frame is dropped as a
	// duplicate within the dedup window.
	OnDedup func()

	// ChannelModes resolves Channel.Mode at RX time. Rules whose RX
	// channel is "packet" cause Handle to short-circuit; rules whose
	// ToChannel is "packet" are skipped per-rule. Nil = treat every
	// channel as ChannelModeAPRS (preserves the legacy any-channel-
	// does-anything behavior). Lookup errors are silently ignored
	// (fail-open).
	ChannelModes configstore.ChannelModeLookup
}

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

type Rule struct {
	FromChannel uint32
	ToChannel   uint32
	Alias       string // "WIDE", "TRACE", or an exact callsign for AliasTypeExact
	AliasType   string // "widen"|"trace"|"exact"
	MaxHops     uint32
	Action      string // "repeat"|"drop"
	Priority    uint32
}

type Stats struct {
	Packets uint64 // successfully digipeated
	Deduped uint64 // dropped as duplicate
}