ads

type Client interface {
	GetHTTPClientPropertiesByHost(ctx context.Context, address string) (<-chan HTTPClientPropertiesResponse, error)
	GetTCPClientPropertiesByHost(ctx context.Context, address string) (<-chan ClientPropertiesResponse, error)
	GetListenerProperties(ctx context.Context, address string) (<-chan ListenerPropertiesResponse, error)

	// SetSearchDomains updates the search domain list specified at creation with domains
	SetSearchDomains(domains []string)

	// GetSearchDomains returns the currently configured search domain list for this client
	GetSearchDomains() []string

	// IncrementActiveRequestsCount increments the active requests count for the endpoint given its address.
	// Should be invoked when a connection is successfully established to the endpoint and a request is sent to it.
	IncrementActiveRequestsCount(address string)

	// DecrementActiveRequestsCount decrements the active requests count for the endpoint given its address
	// Should be invoked when the endpoint finished processing a request
	DecrementActiveRequestsCount(address string)
}

type ClientProperties interface {
	// Address returns the address of the endpoint
	Address() (net.Addr, error)

	// UseTLS returns true if the target service accept TLS traffic
	UseTLS() bool

	// Permissive returns true if the target service accepts both TLS and plaintext traffic
	Permissive() bool

	// ServerName returns the SNI of the target HTTP service when connection to one of its endpoints
	// is made through TLS
	ServerName() string

	// Metadata returns the metadata associated with the target service
	Metadata() map[string]interface{}
}

type ClientPropertiesResponse interface {
	ClientProperties() ClientProperties

	// Error in case retrieving ClientProperties failed returns the error causing the failure
	Error() error
}

type HTTPClientPropertiesResponse interface {
	ClientProperties() ClientProperties

	// Error in case retrieving HTTPClientProperties failed returns the error causing the failure
	Error() error
}

type HostNotFoundError struct {
	HostName string
}

type ListenerProperties interface {
	// UseTLS returns true if the workload accepts TLS traffic
	UseTLS() bool

	// Permissive returns true if the workload accepts both plaintext and TLS traffic
	Permissive() bool

	// IsClientCertificateRequired returns true if client certificate is required
	IsClientCertificateRequired() bool

	// Metadata returns the metadata associated with this listener
	Metadata() map[string]interface{}
}

type ListenerPropertiesResponse interface {
	ListenerProperties() ListenerProperties
	// Error in case retrieving ListenerProperties failed returns the error causing the failure
	Error() error
}

type NoEndpointFoundError struct{}