feat: add index hints

sharp/content.Tests/endpoints/EndpointsTest.cs

@@ -221,4 +221,51 @@ public void Validate_WithInvalidVideoUrl_ThrowsArgumentException()
 
         Assert.Throws<ArgumentException>(() => request.Validate());
     }
+
+    [Fact]
+    public void EnsurePageAndSize_WithValidParameters_DoesNotThrowException()
+    {
+        // Arrange
+        long? page = 1;
+        int? size = 10;
+
+        // Act
+        var ex = Record.Exception(() => Endpoints.EnsurePageAndSize(page, size));
+
+        // Assert
+        Assert.Null(ex);
+    }
+
+    [Fact]
+    public void EnsurePageAndSize_WithNegativePage_ThrowsArgumentOutOfRangeException()
+    {
+        // Arrange
+        long? page = -1;
+        int? size = 10;
+
+        // Act & Assert
+        Assert.Throws<ArgumentOutOfRangeException>(() => Endpoints.EnsurePageAndSize(page, size));
+    }
+
+    [Fact]
+    public void EnsurePageAndSize_WithNegativeSize_ThrowsArgumentOutOfRangeException()
+    {
+        // Arrange
+        long? page = 1;
+        int? size = -1;
+
+        // Act & Assert
+        Assert.Throws<ArgumentOutOfRangeException>(() => Endpoints.EnsurePageAndSize(page, size));
+    }
+
+    [Fact]
+    public void EnsurePageAndSize_WithSizeGreaterThan20_ThrowsArgumentOutOfRangeException()
+    {
+        // Arrange
+        long? page = 1;
+        int? size = 21;
+
+        // Act & Assert
+        Assert.Throws<ArgumentOutOfRangeException>(() => Endpoints.EnsurePageAndSize(page, size));
+    }
 }

sharp/content/endpoints/Endpoints.cs

@@ -21,15 +21,24 @@ public class VideoRequest
 
 public static class Endpoints
 {
-    public static Task<Pagination<VideoDto>> UserVideos(IDomainService service, long userId, long? page, int? size) =>
-        service.FindByUserId(userId, page ?? long.MaxValue, size ?? 10);
+    public static Task<Pagination<VideoDto>> UserVideos(IDomainService service, long userId, long? page, int? size)
+    {
+        EnsurePageAndSize(page, size);
+        return service.FindByUserId(userId, page ?? long.MaxValue, size ?? 10);
+    }
 
-    public static Task<Pagination<VideoDto>> Videos(IDomainService service, long? page, int? size) =>
-        service.FindRecent(page ?? long.MaxValue, size ?? 10);
+    public static Task<Pagination<VideoDto>> Videos(IDomainService service, long? page, int? size)
+    {
+        EnsurePageAndSize(page, size);
+        return service.FindRecent(page ?? long.MaxValue, size ?? 10);
+    }
 
 
-    public static Task<IReadOnlyList<VideoDto>> Likes(IDomainService service, long userId, long? page, int? size) =>
-        service.VotedVideos(userId, page ?? long.MaxValue, size ?? 10);
+    public static Task<IReadOnlyList<VideoDto>> Likes(IDomainService service, long userId, long? page, int? size)
+    {
+        EnsurePageAndSize(page, size);
+        return service.VotedVideos(userId, page ?? long.MaxValue, size ?? 10);
+    }
 
 
     public static void Vote(IDomainService service, VoteRequest request) => service.Vote(
@@ -87,4 +96,17 @@ public static void Validate(this VideoRequest request)
             throw new ArgumentException("Video url is null or empty", nameof(request.VideoUrl));
         }
     }
+
+    public static void EnsurePageAndSize(long? page, int? size)
+    {
+        if (page is < 0)
+        {
+            throw new ArgumentOutOfRangeException(nameof(page));
+        }
+
+        if (size is < 0 or > 20)
+        {
+            throw new ArgumentOutOfRangeException(nameof(size));
+        }
+    }
 }

sharp/content/repository/Content.cs

@@ -93,7 +93,7 @@ public async Task<IReadOnlyList<Video>> FindByUserId(long userId, long page, int
         await using var connection = await dataSource.OpenConnectionAsync();
         var videos = await connection.QueryAsync<Video>(
             "SELECT id,user_id, title, des, cover_url, video_url, duration, view_count, like_count, created_at, updated_at, processed " +
-            "FROM videos WHERE processed = 1 AND  user_id = @userId AND id < @page ORDER BY id DESC LIMIT @size",
+            "FROM videos FORCE INDEX(user_created) WHERE processed = 1 AND  user_id = @userId AND id < @page ORDER BY id DESC LIMIT @size",
             new { userId, page, size });
         return videos.ToList();
     }
@@ -103,7 +103,7 @@ public async Task<IReadOnlyList<Video>> FindRecent(long page, int size)
         await using var connection = await dataSource.OpenConnectionAsync();
         var videos = await connection.QueryAsync<Video>(
             "SELECT id ,user_id, title, des, cover_url, video_url, duration, view_count, like_count, created_at, updated_at, processed " +
-            "FROM videos WHERE processed = 1 AND id < @page ORDER BY id DESC LIMIT @size",
+            "FROM videos FORCE INDEX (processed) WHERE processed = 1 AND id < @page ORDER BY id DESC LIMIT @size",
             new { page, size });
         return videos.ToList();
     }