messagehandler

type DNSMessageHandler interface {
	// NotifyOnDNSMsg handles DNS data when the in-agent DNS proxy sees a
	// DNS message. It emits monitor events, proxy metrics and stores DNS
	// data in the DNS cache. To update the DNS cache, it will call
	// UpdateOnDNSMsg() if the DNS message is a response.
	NotifyOnDNSMsg(lookupTime time.Time,
		ep *endpoint.Endpoint,
		epIPPort string,
		serverID identity.NumericIdentity,
		serverAddrPort netip.AddrPort,
		msg *dns.Msg,
		protocol string,
		allowed bool,
		stat *dnsproxy.ProxyRequestContext,
	) error

	// UpdateOnDNSMsg updates the DNS cache with the DNS message data.
	// It is called when the DNS message is a response. It is called by
	// NotifyOnDNSMsg() to update the DNS cache and standalone DNS
	// proxy grpc server with the DNS message data.
	UpdateOnDNSMsg(lookupTime time.Time,
		ep *endpoint.Endpoint,
		qname string,
		responseIPs []netip.Addr,
		TTL int,
		stat *dnsproxy.ProxyRequestContext,
	)

	SetBindPort(uint16)
}

type DNSMessageHandlerParams struct {
	cell.In

	Lifecycle         cell.Lifecycle
	Logger            *slog.Logger
	NameManager       namemanager.NameManager
	ProxyAccessLogger accesslog.ProxyAccessLogger
}