readers

type Capability string

type CapabilityProvider interface {
	Capabilities() []Capability
}

type DriverMetadata struct {
	ID                string
	Description       string
	DefaultEnabled    bool
	DefaultAutoDetect bool
}

type Reader interface {
	// Metadata returns static configuration for this driver.
	Metadata() DriverMetadata
	// IDs returns the device string prefixes supported by this reader.
	IDs() []string
	// Open any necessary connections to the device and start polling.
	// Takes a device connection string and a channel to send scanned tokens.
	Open(config.ReadersConnect, chan<- Scan) error
	// Close any open connections to the device and stop polling.
	Close() error
	// Detect attempts to search for a connected device and returns the device
	// connection string. If no device is found, an empty string is returned.
	// Takes a list of currently connected device strings.
	Detect([]string) string
	// Path returns the connection path used to open this reader.
	// This is the physical resource identifier (e.g., "/dev/ttyUSB0", PCSC
	// reader name, MQTT broker URL) used to prevent multiple drivers from
	// competing for the same device.
	Path() string
	// Connected returns true if the device is connected and active.
	Connected() bool
	// Info returns a string with information about the connected device.
	Info() string
	// Write sends a string to the device to be written to a token, if
	// that device supports writing. Blocks until completion or timeout.
	Write(string) (*tokens.Token, error)
	// CancelWrite sends a request to cancel an active write request.
	CancelWrite()
	// Capabilities returns the list of capabilities supported by this reader.
	Capabilities() []Capability
	// OnMediaChange is called when the active media changes.
	OnMediaChange(*models.ActiveMedia) error
	// ReaderID returns a deterministic identifier for this reader instance.
	// The ID is stable across service restarts when the hardware stays in
	// the same port. Format: "{driver}-{hash16}" where hash16 is derived
	// from stable hardware attributes like USB topology path.
	ReaderID() string
}

type Scan struct {
	Error       error
	Token       *tokens.Token
	Source      string
	ReaderError bool // True when Token is nil due to reader error/disconnect vs normal token removal
}