package ws import ( "encoding/json" "log" "sync" "github.com/Molecule-AI/molecule-monorepo/platform/internal/models" "github.com/gorilla/websocket" ) // AccessChecker is a function that checks if two workspaces can communicate. type AccessChecker func(callerID, targetID string) bool type Client struct { Conn *websocket.Conn WorkspaceID string // empty for canvas clients Send chan []byte } type Hub struct { mu sync.RWMutex clients map[*Client]bool Register chan *Client Unregister chan *Client canCommunicate AccessChecker done chan struct{} // closed once on shutdown closeOnce sync.Once } func NewHub(canCommunicate AccessChecker) *Hub { return &Hub{ clients: make(map[*Client]bool), Register: make(chan *Client), Unregister: make(chan *Client), canCommunicate: canCommunicate, done: make(chan struct{}), } } func (h *Hub) Run() { for { select { case client := <-h.Register: h.mu.Lock() h.clients[client] = true h.mu.Unlock() log.Printf("WebSocket client connected (workspace=%q)", client.WorkspaceID) case client := <-h.Unregister: h.mu.Lock() if _, ok := h.clients[client]; ok { delete(h.clients, client) close(client.Send) } h.mu.Unlock() case <-h.done: return } } } // safeSend sends data to a client channel without panicking on a closed channel. // Returns false if the channel was closed (i.e. client just disconnected). func safeSend(client *Client, data []byte) (sent bool) { defer func() { if r := recover(); r != nil { // Channel was closed between RLock check and send — client disconnected sent = false } }() select { case client.Send <- data: return true default: return false } } // Broadcast sends a WSMessage to all appropriate clients. func (h *Hub) Broadcast(msg models.WSMessage) { data, err := json.Marshal(msg) if err != nil { log.Printf("WS: marshal error: %v", err) return } h.mu.RLock() defer h.mu.RUnlock() for client := range h.clients { // Canvas clients get everything if client.WorkspaceID == "" { if !safeSend(client, data) { log.Printf("WS: dropped message to canvas client (buffer full or closed)") } continue } // Workspace clients: filter by CanCommunicate if msg.WorkspaceID != "" && h.canCommunicate != nil && h.canCommunicate(client.WorkspaceID, msg.WorkspaceID) { if !safeSend(client, data) { log.Printf("WS: dropped message to workspace %s (buffer full or closed)", client.WorkspaceID) } } } } // WritePump reads from client.Send and writes to the WebSocket. func WritePump(client *Client) { defer client.Conn.Close() for msg := range client.Send { if err := client.Conn.WriteMessage(websocket.TextMessage, msg); err != nil { break } } } // Close disconnects all WebSocket clients gracefully. Safe to call multiple times. func (h *Hub) Close() { h.closeOnce.Do(func() { close(h.done) // signal Run() to exit h.mu.Lock() defer h.mu.Unlock() count := len(h.clients) for client := range h.clients { close(client.Send) client.Conn.Close() delete(h.clients, client) } log.Printf("WebSocket hub closed (%d clients disconnected)", count) }) } // ReadPump reads from WebSocket (keeps connection alive, discards messages). func ReadPump(client *Client, hub *Hub) { defer func() { // Guard against sending to Unregister after hub is closed select { case hub.Unregister <- client: case <-hub.done: } client.Conn.Close() }() for { _, _, err := client.Conn.ReadMessage() if err != nil { break } } }