Merge pull request #16619 from dkanada/person-filter

add NameStartsWith and NameLessThan filters to Person search

Jellyfin.Api/Controllers/PersonsController.cs

@@ -50,6 +50,9 @@ public class PersonsController : BaseJellyfinApiController
     /// <param name="startIndex">Optional. All items with a lower index will be dropped from the response.</param>
     /// <param name="limit">Optional. The maximum number of records to return.</param>
     /// <param name="searchTerm">The search term.</param>
+    /// <param name="nameStartsWith">Optional. Filter by items whose name starts with the given input string.</param>
+    /// <param name="nameLessThan">Optional. Filter by items whose name will appear before this value when sorted alphabetically.</param>
+    /// <param name="nameStartsWithOrGreater">Optional. Filter by items whose name will appear after this value when sorted alphabetically.</param>
     /// <param name="fields">Optional. Specify additional fields of information to return in the output.</param>
     /// <param name="filters">Optional. Specify additional filters to apply.</param>
     /// <param name="isFavorite">Optional filter by items that are marked as favorite, or not. userId is required.</param>
@@ -70,6 +73,9 @@ public class PersonsController : BaseJellyfinApiController
         [FromQuery] int? startIndex,
         [FromQuery] int? limit,
         [FromQuery] string? searchTerm,
+        [FromQuery] string? nameStartsWith,
+        [FromQuery] string? nameLessThan,
+        [FromQuery] string? nameStartsWithOrGreater,
         [FromQuery, ModelBinder(typeof(CommaDelimitedCollectionModelBinder))] ItemFields[] fields,
         [FromQuery, ModelBinder(typeof(CommaDelimitedCollectionModelBinder))] ItemFilter[] filters,
         [FromQuery] bool? isFavorite,
@@ -97,6 +103,9 @@ public class PersonsController : BaseJellyfinApiController
             excludePersonTypes)
         {
             NameContains = searchTerm,
+            NameStartsWith = nameStartsWith,
+            NameLessThan = nameLessThan,
+            NameStartsWithOrGreater = nameStartsWithOrGreater,
             User = user,
             IsFavorite = !isFavorite.HasValue && isFavoriteInFilters ? true : isFavorite,
             AppearsInItemId = appearsInItemId ?? Guid.Empty,

Jellyfin.Server.Implementations/Item/PeopleRepository.cs

@@ -235,6 +235,21 @@ public class PeopleRepository(IDbContextFactory<JellyfinDbContext> dbProvider, I
             query = query.Where(e => e.Name.ToUpper().Contains(nameContainsUpper));
         }
 
+        if (!string.IsNullOrWhiteSpace(filter.NameStartsWith))
+        {
+            query = query.Where(e => e.Name.StartsWith(filter.NameStartsWith.ToLowerInvariant()));
+        }
+
+        if (!string.IsNullOrWhiteSpace(filter.NameLessThan))
+        {
+            query = query.Where(e => e.Name.CompareTo(filter.NameLessThan.ToLowerInvariant()) < 0);
+        }
+
+        if (!string.IsNullOrWhiteSpace(filter.NameStartsWithOrGreater))
+        {
+            query = query.Where(e => e.Name.CompareTo(filter.NameStartsWithOrGreater.ToLowerInvariant()) >= 0);
+        }
+
         return query;
     }
 

MediaBrowser.Controller/Entities/InternalPeopleQuery.cs

@@ -42,6 +42,12 @@ namespace MediaBrowser.Controller.Entities
 
         public string NameContains { get; set; }
 
+        public string NameStartsWith { get; set; }
+
+        public string NameLessThan { get; set; }
+
+        public string NameStartsWithOrGreater { get; set; }
+
         public User User { get; set; }
 
         public bool? IsFavorite { get; set; }