apitype

type DNSConfig struct {
	// Resolvers are the global DNS resolvers to use
	// overriding the local OS configuration.
	Resolvers []DNSResolver `json:"resolvers"`

	// FallbackResolvers are used as global resolvers when
	// the client is unable to determine the OS's preferred DNS servers.
	FallbackResolvers []DNSResolver `json:"fallbackResolvers"`

	// Routes map DNS name suffixes to a set of DNS resolvers,
	// used for Split DNS and other advanced routing overlays.
	Routes map[string][]DNSResolver `json:"routes"`

	// Domains are the search domains to use.
	Domains []string `json:"domains"`

	// Proxied means MagicDNS is enabled.
	Proxied bool `json:"proxied"`

	// TempCorpIssue13969 is from an internal hack day prototype,
	// See tailscale/corp#13969.
	TempCorpIssue13969 string `json:"TempCorpIssue13969,omitempty"`

	// Nameservers are the IP addresses of global nameservers to use.
	// This is a deprecated format but may still be found in tailnets
	// that were configured a long time ago. When making updates,
	// set Resolvers and leave Nameservers empty.
	Nameservers []string `json:"nameservers"`
}

type DNSOSConfig struct {
	Nameservers   []string
	SearchDomains []string
	MatchDomains  []string
}

type DNSQueryResponse struct {
	// Bytes is the raw DNS response bytes.
	Bytes []byte
	// Resolvers is the list of resolvers that the forwarder deemed able to resolve the query.
	Resolvers []*dnstype.Resolver
}

type DNSResolver struct {
	// Addr is the address of the DNS resolver.
	// It is usually an IP address or a DoH URL.
	// See dnstype.Resolver.Addr for full details.
	Addr string `json:"addr"`

	// BootstrapResolution is an optional suggested resolution for
	// the DoT/DoH resolver.
	BootstrapResolution []string `json:"bootstrapResolution,omitempty"`

	// UseWithExitNode signals this resolver should be used
	// even when a tailscale exit node is configured on a device.
	UseWithExitNode bool `json:"useWithExitNode,omitempty"`
}

type ExitNodeSuggestionResponse struct {
	ID       tailcfg.StableNodeID
	Name     string
	Location tailcfg.LocationView `json:",omitempty"`
}

type FileTarget struct {
	Node *tailcfg.Node

	// PeerAPI is the http://ip:port URL base of the node's PeerAPI,
	// without any path (not even a single slash).
	PeerAPIURL string
}

type OptionalFeatures struct {
	// Features is the map of optional feature names to whether they are
	// enabled.
	//
	// Disabled features may be absent from the map. (That is, false values
	// are not guaranteed to be present.)
	Features map[string]bool
}

type ReloadConfigResponse struct {
	Reloaded bool   // whether the config was reloaded
	Err      string // any error message
}

type SetPushDeviceTokenRequest struct {
	// PushDeviceToken is the iOS/macOS APNs device token (and any future Android equivalent).
	PushDeviceToken string
}

type WaitingFile struct {
	Name string
	Size int64
}

type WhoIsResponse struct {
	Node        *tailcfg.Node
	UserProfile *tailcfg.UserProfile

	// CapMap is a map of capabilities to their values.
	// See tailcfg.PeerCapMap and tailcfg.PeerCapability for details.
	CapMap tailcfg.PeerCapMap
}