resolver

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

type CacheStats struct {
	Hit  uint32 `json:"hit"`
	Miss uint32 `json:"miss"`
}

type Cacher interface {
	// Get returns the cached value for key. Returned value must be treated as
	// immutable by callers.
	Get(key uint64) (value *cacheValue, ok bool)

	// Set stores value in the cache. The cache implementation is responsible for
	// computing the cost (typically based on response size in bytes).
	Set(key uint64, value *cacheValue)
}

type ClientInfo struct {
	ID    string
	IP    string
	Model string
	Name  string
}

type DNS struct {
	DOH     DOH
	DNS53   DNS53
	Manager *endpoint.Manager
	// contains filtered or unexported fields
}

type DNS53 struct {
	Dialer *net.Dialer

	// Cache defines the cache storage implementation for DNS response cache. If
	// nil, caching is disabled.
	Cache Cacher

	// CacheMaxAge defines the maximum age in second allowed for a cached entry
	// before being considered stale regardless of the records TTL.
	CacheMaxAge uint32

	// MaxTTL defines the maximum TTL value that will be handed out to clients.
	// The specified maximum TTL will be given to clients instead of the true
	// TTL value if it is lower. The true TTL value is however kept in the cache
	// to evaluate cache entries freshness.
	MaxTTL uint32
}

type DOH struct {
	// URL specifies the DoH upstream URL.
	URL string

	// GetProfileURL provides a DoH upstream url for q. If GetProfileURL is
	// defined, URL is ignored.
	GetProfileURL func(q query.Query) (url, profile string)

	// Cache defines the cache storage implementation for DNS response cache. If
	// nil, caching is disabled.
	Cache Cacher

	// CacheMaxAge defines the maximum age in second allowed for a cached entry
	// before being considered stale regardless of the records TTL.
	CacheMaxAge uint32

	// MaxTTL defines the maximum TTL value that will be handed out to clients.
	// The specified maximum TTL will be given to clients instead of the true
	// TTL value if it is lower. The true TTL value is however kept in the cache
	// to evaluate cache entries freshness.
	MaxTTL uint32

	// ExtraHeaders specifies headers to be added to all DoH requests.
	ExtraHeaders http.Header

	// ClientInfo is called for each query in order gather client information to
	// embed with the request.
	ClientInfo func(query.Query) ClientInfo
	// contains filtered or unexported fields
}

type ResolveInfo struct {
	Transport string
	Profile   string
	FromCache bool
}

type Resolver interface {
	// Resolve send q and write the response into buf. If buf too small,
	// response is truncated. It is fine to reuse the same []byte for q.Payload
	// and buf.
	//
	// When caching is enabled, a cached response is returned if a valid entry
	// is found in the cache for q. In case of err with cache enabled, an
	// expired fallback entry may be stored in buf. In such case, n is > 0.
	Resolve(ctx context.Context, q query.Query, buf []byte) (n int, i ResolveInfo, err error)
}