ssdp

type Device interface {
	// The product name (e.g. "Sonos")
	Product() string
	// The device name (e.h. "ZonePlayer")
	Name() string
	// A URI that can be queried for device capabilities
	Location() Location
	// The device's Universally Unique ID
	UUID() UUID
	// Search for a service in the device's capabilities; same
	// return semantics as querying a map
	Service(key ServiceKey) (service Service, has bool)
}

type DeviceMap map[UUID]Device

type Location string

type Manager interface {
	// Initiates SSDP discovery, where port gives a free port on that network
	// device to listen for responses, and the subscribe flag (currrently unimplemented)
	// determines whether to listen to asynchronous updates after the
	// initial query is complete.
	Discover(port int, subscribe bool) error
	// After discovery is complete searches for devices implementing
	// the services specified in query.
	QueryServices(query ServiceQueryTerms) ServiceMap
	// Return the list of devices that were found during discovery
	Devices() DeviceMap
	// Shuts down asynchronous subscriptions to device state
	Close() error
}

type Service interface {
	// The version of the service
	Version() int64
}

type ServiceKey string

type ServiceMap map[ServiceKey]DeviceMap

type ServiceQueryTerms map[ServiceKey]int64

type UUID string