fn_registry/functions/infra/ws_hub.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	params	output	tested	tests	test_file_path	file_path
ws_hub	function	go	infra	1.0.0	impure	func NewWSHub() *WSHub	Crea un WSHub con canales Broadcast (buffereado, capacidad 256), Register y Unregister. El metodo Run() ejecuta el loop principal: select sobre Register/Unregister/Broadcast. Stop() cierra el loop y limpia todos los clientes. Patron hub clasico de Go: un solo writer al mapa de clientes, sin mutex.	websocket hub server broadcast infra realtime		WSHub_go_infra WSClient_go_infra	WSHub_go_infra	false	error_go_core			*WSHub listo para usar. Llamar a Run() en una goroutine para activar el loop. Llamar a Stop() para terminar limpiamente.	true	registra y desregistra clientes broadcast envia mensaje a todos los clientes cliente lento es desconectado del hub Stop cierra todos los clientes	functions/infra/ws_test.go	functions/infra/ws_hub.go

Ejemplo

hub := NewWSHub()
go hub.Run()
defer hub.Stop()

// Cualquier goroutine puede broadcastear
WSBroadcast(hub, []byte("evento"))

Notas

El loop Run() es bloqueante y esta diseñado para correr como goroutine durante toda la vida del proceso. La unica forma de pararlo es llamar a Stop().

Un cliente lento (cuyo canal Send esta lleno) es desconectado automaticamente del hub durante el broadcast — esta es la garantia anti-backpressure: ningun cliente puede bloquear el broadcast a los demas.

El hub no autentica ni autoriza — es solo un fan-out. La auth se hace en el handler antes de registrar el cliente.