Struct VNCSession

internal/vnc/session_manager.go:60–93

VNCSession represents an active VNC session with comprehensive metadata and lifecycle management. Each session corresponds to a single VNC connection to a Proxmox target (VM, container, or node shell).

// and lifecycle management. Each session corresponds to a single VNC connection
// to a Proxmox target (VM, container, or node shell).
type VNCSession struct {
	// ID is a unique identifier for this session, used for tracking and management
	ID string

	// Target information for the VNC connection
	TargetType SessionType // "vm", "lxc", or "node"
	NodeName   string      // Proxmox node name
	VMID       string      // VM/Container ID (empty for node shells)
	TargetName string      // Display name for the target

	// Network configuration
	Port int    // Local HTTP server port for this session
	URL  string // Full URL to access this session

	// Session lifecycle tracking
	CreatedAt time.Time    // When this session was created
	LastUsed  time.Time    // Last time this session was accessed
	State     SessionState // Current connection state

	// VNC connection details
	ProxyConfig *ProxyConfig // VNC proxy configuration from Proxmox API

	// Server management
	Server *Server // The HTTP server instance for this session

	// Connection tracking
	activeConnections int             // Number of active WebSocket connections
	disconnectChan    chan struct{}   // Channel to signal disconnection
	sessionManager    *SessionManager // Reference to session manager for cleanup notifications

	// Cleanup management
	cancelFunc context.CancelFunc // Function to cancel the session context
	mutex      sync.RWMutex       // Protects concurrent access to session fields
}

// UpdateLastUsed updates the last used timestamp for this session.
// This is called whenever the session is accessed to track activity