Files
qbz/crates/qbz-models/src/events.rs
T

134 lines
3.6 KiB
Rust

//! Core events for frontend communication
//!
//! This module defines all events that flow from the core to frontends.
//! Frontends implement FrontendAdapter to receive these events.
use serde::Serialize;
use crate::playback::{PlaybackState, PlaybackStatus, QueueState, QueueTrack};
use crate::types::{Playlist, SearchResults, UserSession};
/// All events emitted by QBZ core to frontends
#[derive(Debug, Clone, Serialize)]
#[serde(tag = "type", content = "data")]
pub enum CoreEvent {
// ============ Playback Events ============
/// Track started playing
TrackStarted {
track: QueueTrack,
position_secs: u64,
},
/// Playback state changed (play/pause/stop)
PlaybackStateChanged { state: PlaybackState },
/// Playback position updated (periodic, e.g., every second)
PositionUpdated {
position_secs: u64,
duration_secs: u64,
},
/// Track finished playing naturally
TrackEnded { track_id: u64 },
/// Volume changed
VolumeChanged { volume: f32 },
/// Full playback status update
PlaybackStatusUpdated { status: PlaybackStatus },
// ============ Queue Events ============
/// Queue state changed (tracks added/removed/reordered)
QueueUpdated { state: QueueState },
/// Shuffle mode changed
ShuffleChanged { enabled: bool },
/// Repeat mode changed
RepeatModeChanged { mode: crate::playback::RepeatMode },
// ============ Authentication Events ============
/// User logged in successfully
LoggedIn { session: UserSession },
/// User logged out
LoggedOut,
/// Session expired or became invalid
SessionExpired,
// ============ Library Events ============
/// Favorites updated
FavoritesUpdated {
/// Type of favorite that changed: "album", "track", or "artist"
favorite_type: String,
},
/// Playlist created
PlaylistCreated { playlist: Playlist },
/// Playlist updated (tracks added/removed)
PlaylistUpdated { playlist_id: u64 },
/// Playlist deleted
PlaylistDeleted { playlist_id: u64 },
// ============ Loading/Progress Events ============
/// Loading started for an operation
LoadingStarted { operation: String },
/// Loading completed
LoadingCompleted { operation: String },
/// Download progress for offline content
DownloadProgress { track_id: u64, progress_percent: u8 },
/// Download completed
DownloadCompleted { track_id: u64 },
// ============ Error Events ============
/// An error occurred
Error {
code: String,
message: String,
/// Whether error is recoverable
recoverable: bool,
},
/// Playback error (track couldn't play)
PlaybackError { track_id: u64, message: String },
/// Network error
NetworkError { message: String },
// ============ Audio System Events ============
/// Audio device changed
AudioDeviceChanged { device_name: String },
/// Audio backend changed
AudioBackendChanged {
/// Backend name: "pipewire", "alsa", "pulse"
backend: String,
},
/// Audio system diagnostic info
AudioDiagnostic { message: String },
// ============ Search Events ============
/// Search results received
SearchResultsReceived {
query: String,
results: SearchResults,
},
// ============ Navigation Hints ============
/// Suggest navigation to album
NavigateToAlbum { album_id: String },
/// Suggest navigation to artist
NavigateToArtist { artist_id: u64 },
/// Suggest navigation to playlist
NavigateToPlaylist { playlist_id: u64 },
}