From 5cbafa566dab227214f60924332cb0e4bfa75b32 Mon Sep 17 00:00:00 2001
From: mbastian77 <michael.bastian@visop.de>
Date: Wed, 15 Jul 2026 16:03:56 +0200
Subject: Add XML docs to small session model types and remove CS1591
 suppressions

---
 MediaBrowser.Model/Session/MessageCommand.cs   | 13 ++++++++++++-
 MediaBrowser.Model/Session/PlayMethod.cs       | 16 ++++++++++++++--
 MediaBrowser.Model/Session/PlaystateRequest.cs | 11 +++++++++--
 MediaBrowser.Model/Session/QueueItem.cs        | 10 +++++++++-
 MediaBrowser.Model/Session/RepeatMode.cs       | 16 ++++++++++++++--
 5 files changed, 58 insertions(+), 8 deletions(-)

(limited to 'MediaBrowser.Model')

diff --git a/MediaBrowser.Model/Session/MessageCommand.cs b/MediaBrowser.Model/Session/MessageCommand.cs
index cc9db8e6c5..e041a9cccd 100644
--- a/MediaBrowser.Model/Session/MessageCommand.cs
+++ b/MediaBrowser.Model/Session/MessageCommand.cs
@@ -1,17 +1,28 @@
 #nullable disable
-#pragma warning disable CS1591
 
 using System.ComponentModel.DataAnnotations;
 
 namespace MediaBrowser.Model.Session
 {
+    /// <summary>
+    /// A command to display a message on a client.
+    /// </summary>
     public class MessageCommand
     {
+        /// <summary>
+        /// Gets or sets the message header.
+        /// </summary>
         public string Header { get; set; }
 
+        /// <summary>
+        /// Gets or sets the message text.
+        /// </summary>
         [Required(AllowEmptyStrings = false)]
         public string Text { get; set; }
 
+        /// <summary>
+        /// Gets or sets the timeout in milliseconds after which the message should be dismissed.
+        /// </summary>
         public long? TimeoutMs { get; set; }
     }
 }
diff --git a/MediaBrowser.Model/Session/PlayMethod.cs b/MediaBrowser.Model/Session/PlayMethod.cs
index 8067627843..2bd11cc91a 100644
--- a/MediaBrowser.Model/Session/PlayMethod.cs
+++ b/MediaBrowser.Model/Session/PlayMethod.cs
@@ -1,11 +1,23 @@
-#pragma warning disable CS1591
-
 namespace MediaBrowser.Model.Session
 {
+    /// <summary>
+    /// The play method.
+    /// </summary>
     public enum PlayMethod
     {
+        /// <summary>
+        /// The media is transcoded before it is sent to the client.
+        /// </summary>
         Transcode = 0,
+
+        /// <summary>
+        /// The media is remuxed into a compatible container but the streams are not re-encoded.
+        /// </summary>
         DirectStream = 1,
+
+        /// <summary>
+        /// The media is sent to the client as-is.
+        /// </summary>
         DirectPlay = 2
     }
 }
diff --git a/MediaBrowser.Model/Session/PlaystateRequest.cs b/MediaBrowser.Model/Session/PlaystateRequest.cs
index ba2c024b76..040affa144 100644
--- a/MediaBrowser.Model/Session/PlaystateRequest.cs
+++ b/MediaBrowser.Model/Session/PlaystateRequest.cs
@@ -1,11 +1,18 @@
-#pragma warning disable CS1591
-
 namespace MediaBrowser.Model.Session
 {
+    /// <summary>
+    /// A request to change the playstate of a session.
+    /// </summary>
     public class PlaystateRequest
     {
+        /// <summary>
+        /// Gets or sets the playstate command.
+        /// </summary>
         public PlaystateCommand Command { get; set; }
 
+        /// <summary>
+        /// Gets or sets the seek position in ticks.
+        /// </summary>
         public long? SeekPositionTicks { get; set; }
 
         /// <summary>
diff --git a/MediaBrowser.Model/Session/QueueItem.cs b/MediaBrowser.Model/Session/QueueItem.cs
index 43920a8464..b9f3181da0 100644
--- a/MediaBrowser.Model/Session/QueueItem.cs
+++ b/MediaBrowser.Model/Session/QueueItem.cs
@@ -1,13 +1,21 @@
 #nullable disable
-#pragma warning disable CS1591
 
 using System;
 
 namespace MediaBrowser.Model.Session;
 
+/// <summary>
+/// An item in a play queue.
+/// </summary>
 public record QueueItem
 {
+    /// <summary>
+    /// Gets or sets the item id.
+    /// </summary>
     public Guid Id { get; set; }
 
+    /// <summary>
+    /// Gets or sets the playlist item id.
+    /// </summary>
     public string PlaylistItemId { get; set; }
 }
diff --git a/MediaBrowser.Model/Session/RepeatMode.cs b/MediaBrowser.Model/Session/RepeatMode.cs
index c6e173d6b8..c6c657d220 100644
--- a/MediaBrowser.Model/Session/RepeatMode.cs
+++ b/MediaBrowser.Model/Session/RepeatMode.cs
@@ -1,11 +1,23 @@
-#pragma warning disable CS1591
-
 namespace MediaBrowser.Model.Session
 {
+    /// <summary>
+    /// The repeat mode of a play queue.
+    /// </summary>
     public enum RepeatMode
     {
+        /// <summary>
+        /// Nothing is repeated.
+        /// </summary>
         RepeatNone = 0,
+
+        /// <summary>
+        /// The whole queue is repeated.
+        /// </summary>
         RepeatAll = 1,
+
+        /// <summary>
+        /// The current item is repeated.
+        /// </summary>
         RepeatOne = 2
     }
 }
-- 
cgit v1.2.3