relay

var (
	// ErrInvalidLane indicates missing resources or invalid lane generation metadata.
	ErrInvalidLane = errors.New("invalid relay lane")
	// ErrInvalidWireGuardPacket indicates a data frame without a structurally valid WireGuard packet.
	ErrInvalidWireGuardPacket = errors.New("invalid WireGuard packet")
	// ErrRemoteClosed indicates an intentional close received from the relay peer.
	ErrRemoteClosed = errors.New("relay session closed by peer")
	// ErrPingTimeout indicates that an admitted timing request received no response within its lane budget.
	ErrPingTimeout = errors.New("lane ping timed out")
	// ErrUnexpectedPong indicates a response that does not match the sole outstanding timing request.
	ErrUnexpectedPong = errors.New("unexpected lane pong")
	// ErrClockSyncRequired indicates data arrived before the generation's initial clock mapping.
	ErrClockSyncRequired = errors.New("initial clock sync required")
	// ErrUnexpectedFrame indicates a valid frame type used outside its protocol phase.
	ErrUnexpectedFrame = errors.New("unexpected in-session frame")
	// ErrLaneAbandoned marks scheduler cancellation that must discard the generation's buffered carrier bytes.
	ErrLaneAbandoned = errors.New("relay lane abandoned")
)

var (
	// ErrInvalidDeadlinePolicy indicates a zero or protocol-invalid packet lifetime.
	ErrInvalidDeadlinePolicy = errors.New("invalid packet deadline policy")
	// ErrCounterExhausted indicates that a direction-local identifier space is exhausted.
	ErrCounterExhausted = errors.New("relay counter exhausted")
	// ErrInvalidPacket indicates inconsistent relay packet metadata.
	ErrInvalidPacket = errors.New("invalid relay packet")
)

var (
	// ErrInvalidReceiver indicates missing endpoint, clock, or deduplication configuration.
	ErrInvalidReceiver = errors.New("invalid relay receiver")
	// ErrInvalidPacketDeadline indicates a deadline that cannot describe bounded in-flight work.
	ErrInvalidPacketDeadline = errors.New("invalid packet deadline")
	// ErrEndpointFailure indicates that a relay UDP endpoint could not be created, read, or written.
	ErrEndpointFailure = errors.New("relay UDP endpoint failure")
)

var (
	// ErrInvalidScheduler indicates missing ingress state.
	ErrInvalidScheduler = errors.New("invalid relay scheduler")
	// ErrInvalidRegistration indicates incomplete lane scheduling metadata.
	ErrInvalidRegistration = errors.New("invalid lane registration")
	// ErrStaleLane indicates a non-increasing connection generation.
	ErrStaleLane = errors.New("stale lane generation")
	// ErrNoActiveLane indicates that no carrier can accept a control frame.
	ErrNoActiveLane = errors.New("no active relay lane")
)

var (
	// ErrInvalidTransmissionStore indicates invalid lane transmission limits or state.
	ErrInvalidTransmissionStore = errors.New("invalid transmission store")
	// ErrInvalidTransmission indicates inconsistent retained packet metadata.
	ErrInvalidTransmission = errors.New("invalid transmission")
	// ErrInvalidDeliveryReport indicates cumulative progress that cannot describe the sent prefix.
	ErrInvalidDeliveryReport = errors.New("invalid delivery report")
)