remote

type BuildOptions struct {
	LAN        []net.IP
	WAN        net.IP // nil when unknown or remote access is off
	LocalPort  int    // port the server listens on (32400)
	PublicPort int    // external port on the WAN; 0 = LocalPort
	// CertHash is the plex.direct hash of a valid plex.direct certificate.
	// Without it no https plex.direct URIs are produced.
	CertHash string
	// Secure is SecureRequired, SecurePreferred (default) or SecureDisabled.
	Secure string
	// CustomURLs are owner-supplied URLs (reverse proxies, DDNS names).
	CustomURLs []string
	// HTTPSOnPlainIP adds https://<ip>:port URIs (self-signed setups). Off
	// by default because clients cannot validate a certificate for a bare IP.
	HTTPSOnPlainIP bool
}

type Connection struct {
	Protocol string `json:"protocol"` // "http" or "https"
	Address  string `json:"address"`  // IP or host
	Port     int    `json:"port"`
	URI      string `json:"uri"`
	Local    bool   `json:"local"`
	Relay    bool   `json:"relay,omitempty"`
	IPv6     bool   `json:"IPv6,omitempty"`
	Custom   bool   `json:"custom,omitempty"` // owner-supplied custom URL
}

type DiscoverOptions struct {
	// Target is where M-SEARCH is sent; SSDPMulticast when empty. Tests
	// point it at a loopback responder.
	Target string
	// Wait bounds how long responses are collected (default 3s).
	Wait   time.Duration
	Client *http.Client
}

type GDMInfo struct {
	Name              string
	MachineIdentifier string
	Port              int
	Version           string
	UpdatedAt         time.Time
	// ContentType defaults to "plex/media-server".
	ContentType string
}

type GDMOptions struct {
	// Info is called per request so name/version changes apply live.
	Info func() GDMInfo
	// Ports to listen on; DefaultGDMPorts when empty.
	Ports []int
	// ListenAddrs, when set, replaces Ports/multicast with plain unicast
	// sockets on these addresses (e.g. "127.0.0.1:0" in tests).
	ListenAddrs []string
	// Announce sends HELLO on start and every AnnounceInterval (default
	// 15m) to the multicast group, and BYE on stop. Off by default: clients
	// discover servers by searching, and current PMS builds rely on that.
	Announce         bool
	AnnounceInterval time.Duration
	Logger           *slog.Logger
	// contains filtered or unexported fields
}

type GDMReply struct {
	From              *net.UDPAddr
	ContentType       string
	Name              string
	MachineIdentifier string
	Port              int
	Version           string
	UpdatedAt         time.Time
	Headers           http.Header
}

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

type IGD struct {
	Location     string // device description URL
	FriendlyName string
	ServiceType  string
	ControlURL   string
	// LocalIP is this host's address on the interface that reaches the
	// gateway: the internal client for port mappings.
	LocalIP net.IP
	Client  *http.Client
}

type InterfaceAddr struct {
	Interface string
	IP        net.IP
	Net       *net.IPNet
}

type LANOptions struct {
	// IncludeIPv6 adds global/ULA IPv6 addresses. PMS publishes IPv4 LAN
	// addresses by default; plex.tv only returns IPv6 connections when the
	// client asks with includeIPv6=1.
	IncludeIPv6 bool
	// IncludeVirtual keeps docker/VPN/hypervisor interfaces.
	IncludeVirtual bool
}

type MappingStatus struct {
	Active       bool      `json:"active"`
	Method       string    `json:"method,omitempty"`  // "upnp" or "nat-pmp"
	Gateway      string    `json:"gateway,omitempty"` // IGD friendly name or NAT-PMP address
	ExternalIP   string    `json:"externalIp,omitempty"`
	ExternalPort int       `json:"externalPort,omitempty"`
	InternalIP   string    `json:"internalIp,omitempty"`
	InternalPort int       `json:"internalPort,omitempty"`
	Lease        string    `json:"lease,omitempty"` // "permanent" or a duration
	RenewAt      time.Time `json:"renewAt,omitempty"`
	LastError    string    `json:"lastError,omitempty"`
	UpdatedAt    time.Time `json:"updatedAt,omitempty"`
}

type NATPMP struct {
	// Gateway is "ip:port" of the gateway's NAT-PMP service.
	Gateway string
	// Tries bounds retransmissions (RFC: 250ms doubling); default 4.
	Tries int
}

type NATPMPError struct{ Code uint16 }

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

type PortMapperOptions struct {
	// Description appears in the router's mapping table.
	Description string
	// Lease requested from the gateway (default 2h). Renewed at half-life.
	Lease time.Duration
	// DiscoverIGD finds a UPnP gateway; nil uses SSDP multicast discovery.
	DiscoverIGD func(ctx context.Context) (*IGD, error)
	// Gateway returns the NAT-PMP gateway; nil uses DefaultGateway. Return
	// an error to disable NAT-PMP.
	Gateway func() (net.IP, error)
	// NATPMPPort overrides the NAT-PMP port (tests).
	NATPMPPort int
	Logger     *slog.Logger
	Now        func() time.Time
}

type PortMappingEntry struct {
	InternalPort   int
	InternalClient string
	Enabled        bool
	Description    string
	Lease          time.Duration
}

type ProbeResult struct {
	URI     string `json:"uri"`
	OK      bool   `json:"ok"`
	Latency string `json:"latency,omitempty"`
	Error   string `json:"error,omitempty"`
}

type Reachability struct {
	Checked   time.Time `json:"checked"`
	Reachable bool      `json:"reachable"`
	// URI is the first URI that answered with this server's identity.
	URI string `json:"uri,omitempty"`
	// Results has one entry per URI tried.
	Results []ProbeResult `json:"results"`
}

type ReachabilityChecker struct {
	Client  *http.Client
	Timeout time.Duration
}

type UPnPError struct {
	Code        int
	Description string
	HTTPStatus  int
}

type WANDetector struct {
	Endpoints []string
	Client    *http.Client
	Logger    *slog.Logger
}