Refactor user agent detection with typed device info

Introduce UserAgentDeviceInfo and UserAgentDeviceType for structured device detection. Refactor UserAgentHelpers to use modular parser functions and return richer device info (type, model, friendly name). Improve Android model extraction and aliasing. Update tests to cover new device detection logic and Samsung Galaxy models. This enhances extensibility and accuracy of device identification.

Author: Vadim Belov

Sources/EasyExtensions.Tests/UserAgentHelpersTests.cs

@@ -80,6 +80,8 @@ public void GetDevice_Identifies_iOS(string ua, string expected)
         [TestCase("Mozilla/5.0 (Linux; Android 12; Pixel 6 Build/SP1A.210812.016; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/94.0.4606.61 Mobile Safari/537.36", "Android Phone (Pixel 6)")]
         [TestCase("Mozilla/5.0 (Linux; Android 10; SM-G973F Build/QP1A.190711.020) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.159 Mobile Safari/537.36", "Android Phone (SM-G973F)")]
         [TestCase("Mozilla/5.0 (Linux; Android 10; SM-G973F) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.159 Mobile Safari/537.36", "Android Phone")]
+        [TestCase("Mozilla/5.0 (Linux; Android 13; SM-G981B) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/144.0.0.0 Mobile Safari/537.36", "Android Phone (Samsung Galaxy S20)")]
+        [TestCase("Mozilla/5.0 (Linux; Android 13; SM-S918B) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/144.0.0.0 Mobile Safari/537.36", "Android Phone (Samsung Galaxy S23 Ultra)")]
         [TestCase("Mozilla/5.0 (Linux; Android 11; SM-T970 Build/RP1A.200720.012) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/88.0.4324.93 Safari/537.36", "Android Tablet (SM-T970)")]
         [TestCase("Mozilla/5.0 (Linux; Android 13; Tablet; rv:102.0) Gecko/102.0 Firefox/102.0", "Android Tablet")]
         public void GetDevice_Identifies_Android(string ua, string expected)

Sources/EasyExtensions/Helpers/UserAgentDeviceInfo.cs

@@ -0,0 +1,41 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2025–2026 Vadim Belov <https://belov.us>
+
+namespace EasyExtensions.Helpers
+{
+    /// <summary>
+    /// Represents device information parsed from a user agent string, including device type, model, and a user-friendly
+    /// name.
+    /// </summary>
+    public sealed class UserAgentDeviceInfo
+    {
+        /// <summary>
+        /// Gets the type of device identified by the user agent string.
+        /// </summary>
+        public UserAgentDeviceType Type { get; }
+
+        /// <summary>
+        /// Gets the name or identifier of the model associated with this instance.
+        /// </summary>
+        public string? Model { get; }
+
+        /// <summary>
+        /// Gets the user-friendly display name associated with the object.
+        /// </summary>
+        public string? FriendlyName { get; }
+
+        /// <summary>
+        /// Initializes a new instance of the UserAgentDeviceInfo class with the specified device type, model, and
+        /// friendly name.
+        /// </summary>
+        /// <param name="type">The type of device represented by this instance.</param>
+        /// <param name="model">The device model name, or null if not specified.</param>
+        /// <param name="friendlyName">A user-friendly name for the device, or null if not specified.</param>
+        public UserAgentDeviceInfo(UserAgentDeviceType type, string? model = null, string? friendlyName = null)
+        {
+            Type = type;
+            Model = model;
+            FriendlyName = friendlyName;
+        }
+    }
+}

Sources/EasyExtensions/Helpers/UserAgentDeviceType.cs

@@ -0,0 +1,96 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2025–2026 Vadim Belov <https://belov.us>
+
+namespace EasyExtensions.Helpers
+{
+    /// <summary>
+    /// Specifies the type of device identified from a user agent string.
+    /// </summary>
+    /// <remarks>
+    /// This enumeration is typically used to classify client devices based on their user agent information, such as
+    /// distinguishing between mobile phones, tablets, desktop computers, and automated agents like bots or scripts.
+    /// The values can be used to tailor application behavior or analytics based on the detected device type.
+    /// </remarks>
+    public enum UserAgentDeviceType
+    {
+        /// <summary>
+        /// The device type cannot be determined from the available user agent information.
+        /// </summary>
+        Unknown = 0,
+
+        /// <summary>
+        /// An automated agent (crawler/indexer) identified as a bot.
+        /// </summary>
+        Bot,
+
+        /// <summary>
+        /// An automated client (for example a scriptable HTTP client) that is not classified as a bot.
+        /// </summary>
+        Script,
+
+        /// <summary>
+        /// A smart TV device.
+        /// </summary>
+        SmartTv,
+
+        /// <summary>
+        /// A game console device.
+        /// </summary>
+        GameConsole,
+
+        /// <summary>
+        /// An Apple iPhone device.
+        /// </summary>
+        IPhone,
+
+        /// <summary>
+        /// An Apple iPad device.
+        /// </summary>
+        IPad,
+
+        /// <summary>
+        /// An Apple iPod device.
+        /// </summary>
+        IPod,
+
+        /// <summary>
+        /// An Android-based phone device.
+        /// </summary>
+        AndroidPhone,
+
+        /// <summary>
+        /// An Android-based tablet device.
+        /// </summary>
+        AndroidTablet,
+
+        /// <summary>
+        /// A ChromeOS device (Chromebook).
+        /// </summary>
+        Chromebook,
+
+        /// <summary>
+        /// A Windows desktop or laptop computer.
+        /// </summary>
+        WindowsPc,
+
+        /// <summary>
+        /// A macOS desktop or laptop computer.
+        /// </summary>
+        Mac,
+
+        /// <summary>
+        /// A Linux desktop or laptop computer.
+        /// </summary>
+        LinuxPc,
+
+        /// <summary>
+        /// A generic mobile device when a more specific classification is not available.
+        /// </summary>
+        Mobile,
+
+        /// <summary>
+        /// A server-side or non-interactive client (for example, backend-to-backend traffic) when recognizable.
+        /// </summary>
+        Server,
+    }
+}