chore: restore product scaffold to rollback baseline

crates/chanora_protocol/src/dto.rs

@@ -13,7 +13,7 @@ pub struct ChannelId(pub u64);
 pub struct ClientId(pub u64);
 
 /// One channel in the server's tree.
-#[derive(Debug, Clone, Serialize, Deserialize)]
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
 pub struct ChannelInfo {
     /// Stable channel id.
     pub id: ChannelId,
@@ -44,7 +44,7 @@ pub enum MessageTarget {
 }
 
 /// An in-channel text message from a specific client.
-#[derive(Debug, Clone, Serialize, Deserialize)]
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
 pub struct ChatMessage {
     /// The client id of the sender.
     pub sender_id: ClientId,
@@ -57,19 +57,17 @@ pub struct ChatMessage {
 }
 
 /// A server-activity notification derived from TeamSpeak bookkeeping events.
-#[derive(Debug, Clone, Serialize, Deserialize)]
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
 pub struct ServerActivity {
     /// Human-readable activity line.
     pub message: String,
 }
 
 /// One connected client on the server.
-#[derive(Debug, Clone, Serialize, Deserialize)]
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
 pub struct ClientInfo {
     /// Stable client id.
     pub id: ClientId,
-    /// Stable TeamSpeak unique identifier for cross-session preference keys.
-    pub uid: String,
     /// Channel the client is currently in.
     pub channel: ChannelId,
     /// Nickname, preserved verbatim per ADR-008.
@@ -88,8 +86,64 @@ pub struct ClientInfo {
     pub talk_power_granted: bool,
 }
 
+/// Best-effort profile and live connection details for one online
+/// client, fetched through the normal TeamSpeak client protocol.
+#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
+pub struct ClientProfile {
+    /// Stable online client id.
+    pub id: ClientId,
+    /// Channel the client is currently in.
+    pub channel: ChannelId,
+    /// Nickname, preserved verbatim per ADR-008.
+    pub name: String,
+    /// TeamSpeak unique id encoded in the canonical base64 form.
+    pub unique_id: String,
+    /// Stable TeamSpeak database id, when visible.
+    pub database_id: Option<u64>,
+    /// ISO country code, when the server exposes one.
+    pub country_code: String,
+    /// User description, when visible.
+    pub description: String,
+    /// Client version string, populated by `clientgetvariables`.
+    pub version: String,
+    /// Client platform string, populated by `clientgetvariables`.
+    pub platform: String,
+    /// Account creation time as Unix seconds.
+    pub created_unix_seconds: Option<i64>,
+    /// Last connection time as Unix seconds.
+    pub last_connected_unix_seconds: Option<i64>,
+    /// Total historical connections, when visible.
+    pub connections_total: Option<u64>,
+    /// Current online duration in seconds, when visible.
+    pub online_seconds: Option<i64>,
+    /// Current idle time in milliseconds, when visible.
+    pub idle_milliseconds: Option<i64>,
+    /// Current ping in milliseconds, when visible.
+    pub ping_milliseconds: Option<i64>,
+    /// Client address. Empty when permission-gated.
+    pub client_address: String,
+    /// Resolved server group names for the online client.
+    pub server_groups: Vec<String>,
+    /// Resolved channel group name for the online client.
+    pub channel_group: String,
+    /// TeamSpeak avatar file path suffix, when an avatar hash is present.
+    pub avatar_path: String,
+    /// Downloaded bytes this month.
+    pub bytes_downloaded_month: Option<u64>,
+    /// Uploaded bytes this month.
+    pub bytes_uploaded_month: Option<u64>,
+    /// Downloaded bytes across all time.
+    pub bytes_downloaded_total: Option<u64>,
+    /// Uploaded bytes across all time.
+    pub bytes_uploaded_total: Option<u64>,
+    /// Client-to-server total packet loss ratio.
+    pub packet_loss_client_to_server_total: Option<f32>,
+    /// Server-to-client total packet loss ratio.
+    pub packet_loss_server_to_client_total: Option<f32>,
+}
+
 /// Snapshot of the server's published state at a moment in time.
-#[derive(Debug, Clone, Serialize, Deserialize)]
+#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
 pub struct ServerSnapshot {
     /// Server name.
     pub server_name: String,