xair-cli/internal/xair/client.go

package xair

import (
	"fmt"
	"net"
	"time"

	"github.com/charmbracelet/log"

	"github.com/hypebeast/go-osc/osc"
)

type parser interface {
	Parse(data []byte) (*osc.Message, error)
}

type XAirClient struct {
	conn      *net.UDPConn
	mixerAddr *net.UDPAddr

	parser parser

	done     chan bool
	respChan chan *osc.Message
}

// NewClient creates a new XAirClient instance
func NewClient(mixerIP string, mixerPort int) (*XAirClient, error) {
	localAddr, err := net.ResolveUDPAddr("udp", fmt.Sprintf(":%d", 0))
	if err != nil {
		return nil, fmt.Errorf("failed to resolve local address: %v", err)
	}

	conn, err := net.ListenUDP("udp", localAddr)
	if err != nil {
		return nil, fmt.Errorf("failed to create UDP connection: %v", err)
	}

	mixerAddr, err := net.ResolveUDPAddr("udp", fmt.Sprintf("%s:%d", mixerIP, mixerPort))
	if err != nil {
		conn.Close()
		return nil, fmt.Errorf("failed to resolve mixer address: %v", err)
	}

	log.Debugf("Local UDP connection: %s	", conn.LocalAddr().String())

	return &XAirClient{
		conn:      conn,
		mixerAddr: mixerAddr,
		parser:    newParser(),
		done:      make(chan bool),
		respChan:  make(chan *osc.Message),
	}, nil
}

// Start begins listening for messages in a goroutine
func (x *XAirClient) StartListening() {
	go x.receiveLoop()
	log.Debugf("Started listening on %s...", x.conn.LocalAddr().String())
}

// receiveLoop handles incoming OSC messages
func (x *XAirClient) receiveLoop() {
	buffer := make([]byte, 4096)

	for {
		select {
		case <-x.done:
			return
		default:
			// Set read timeout to avoid blocking forever
			x.conn.SetReadDeadline(time.Now().Add(100 * time.Millisecond))

			n, _, err := x.conn.ReadFromUDP(buffer)
			if err != nil {
				if netErr, ok := err.(net.Error); ok && netErr.Timeout() {
					// Timeout is expected, continue loop
					continue
				}
				// Check if we're shutting down to avoid logging expected errors
				select {
				case <-x.done:
					return
				default:
					log.Errorf("Read error: %v", err)
					return
				}
			}

			msg, err := x.parseOSCMessage(buffer[:n])
			if err != nil {
				log.Errorf("Failed to parse OSC message: %v", err)
				continue
			}
			x.respChan <- msg
		}
	}
}

// parseOSCMessage parses raw bytes into an OSC message with improved error handling
func (x *XAirClient) parseOSCMessage(data []byte) (*osc.Message, error) {
	msg, err := x.parser.Parse(data)
	if err != nil {
		return nil, err
	}

	return msg, nil
}

// Stop stops the client and closes the connection
func (x *XAirClient) Stop() {
	close(x.done)
	if x.conn != nil {
		x.conn.Close()
	}
}

// SendMessage sends an OSC message to the mixer using the unified connection
func (x *XAirClient) SendMessage(address string, args ...any) error {
	return x.SendToAddress(x.mixerAddr, address, args...)
}

// SendToAddress sends an OSC message to a specific address (enables replying to different ports)
func (x *XAirClient) SendToAddress(addr *net.UDPAddr, oscAddress string, args ...any) error {
	msg := osc.NewMessage(oscAddress)
	for _, arg := range args {
		msg.Append(arg)
	}

	log.Debugf("Sending to %v: %s", addr, msg.String())
	if len(args) > 0 {
		log.Debug(" - Arguments: ")
		for i, arg := range args {
			if i > 0 {
				log.Debug(", ")
			}
			log.Debugf("%v", arg)
		}
	}
	log.Debug("")

	data, err := msg.MarshalBinary()
	if err != nil {
		return fmt.Errorf("failed to marshal message: %v", err)
	}

	_, err = x.conn.WriteToUDP(data, addr)
	return err
}

// RequestInfo requests mixer information
func (x *XAirClient) RequestInfo() (error, InfoResponse) {
	err := x.SendMessage("/xinfo")
	if err != nil {
		return err, InfoResponse{}
	}

	val := <-x.respChan
	var info InfoResponse
	if len(val.Arguments) >= 3 {
		info.Host = val.Arguments[0].(string)
		info.Name = val.Arguments[1].(string)
		info.Model = val.Arguments[2].(string)
	}
	return nil, info
}

// KeepAlive sends keep-alive message (required for multi-client usage)
func (x *XAirClient) KeepAlive() error {
	return x.SendMessage("/xremote")
}

// RequestStatus requests mixer status
func (x *XAirClient) RequestStatus() error {
	return x.SendMessage("/status")
}

// SetChannelGain sets gain for a specific channel (1-based indexing)
func (x *XAirClient) SetChannelGain(channel int, gain float32) error {
	address := fmt.Sprintf("/ch/%02d/mix/fader", channel)
	return x.SendMessage(address, gain)
}

// MuteChannel mutes/unmutes a specific channel (1-based indexing)
func (x *XAirClient) MuteChannel(channel int, muted bool) error {
	address := fmt.Sprintf("/ch/%02d/mix/on", channel)
	var value int32 = 0
	if !muted {
		value = 1
	}
	return x.SendMessage(address, value)
}

// GetMainLRFader requests the current main L/R fader level
func (x *XAirClient) GetMainLRFader() (float64, error) {
	err := x.SendMessage("/lr/mix/fader")
	if err != nil {
		return 0, err
	}

	resp := <-x.respChan
	val, ok := resp.Arguments[0].(float32)
	if !ok {
		return 0, fmt.Errorf("unexpected argument type for main LR fader value")
	}
	return mustDbFrom(float64(val)), nil
}

// SetMainLRFader sets the main L/R fader level
func (x *XAirClient) SetMainLRFader(level float64) error {
	return x.SendMessage("/lr/mix/fader", float32(mustDbInto(level)))
}

// GetChannelFader requests the current fader level for a channel
func (x *XAirClient) GetChannelFader(channel int) (float64, error) {
	address := fmt.Sprintf("/ch/%02d/mix/fader", channel)
	err := x.SendMessage(address)
	if err != nil {
		return 0, err
	}

	resp := <-x.respChan
	val, ok := resp.Arguments[0].(float32)
	if !ok {
		return 0, fmt.Errorf("unexpected argument type for fader value")
	}

	return mustDbFrom(float64(val)), nil
}

// GetChannelMute requests the current mute state for a channel
func (x *XAirClient) GetChannelMute(channel int) error {
	address := fmt.Sprintf("/ch/%02d/mix/on", channel)
	return x.SendMessage(address)
}

// SetChannelName sets the name for a specific channel
func (x *XAirClient) SetChannelName(channel int, name string) error {
	address := fmt.Sprintf("/ch/%02d/config/name", channel)
	return x.SendMessage(address, name)
}

// GetChannelName requests the name for a specific channel
func (x *XAirClient) GetChannelName(channel int) error {
	address := fmt.Sprintf("/ch/%02d/config/name", channel)
	return x.SendMessage(address)
}

// GetChannelColor requests the color for a specific channel
func (x *XAirClient) GetChannelColor(channel int) error {
	address := fmt.Sprintf("/ch/%02d/config/color", channel)
	return x.SendMessage(address)
}

// SetChannelColor sets the color for a specific channel (0-15)
func (x *XAirClient) SetChannelColor(channel int, color int32) error {
	address := fmt.Sprintf("/ch/%02d/config/color", channel)
	return x.SendMessage(address, color)
}

// GetAllChannelInfo requests information for all channels
func (x *XAirClient) GetAllChannelInfo(maxChannels int) error {
	fmt.Printf("\n=== REQUESTING ALL CHANNEL INFO (1-%d) ===\n", maxChannels)
	for ch := 1; ch <= maxChannels; ch++ {
		fmt.Printf("Requesting info for channel %d...\n", ch)
		x.GetChannelName(ch)
		time.Sleep(100 * time.Millisecond)
		x.GetChannelFader(ch)
		time.Sleep(100 * time.Millisecond)
		x.GetChannelMute(ch)
		time.Sleep(100 * time.Millisecond)
		x.GetChannelColor(ch)
		time.Sleep(200 * time.Millisecond) // Longer pause between channels
	}
	return nil
}