thisisnacho · thisisnacho · Jul 4, 2025 · Jul 4, 2025
diff --git a/sample/FastEndpoints/Source/EFModel/BlogContext.cs b/sample/FastEndpoints/Source/EFModel/BlogContext.cs
@@ -0,0 +1,47 @@
+namespace Panner.AspNetCore.Samples.FastEndpointsNet9.EFModel
+{
+    using Microsoft.EntityFrameworkCore;
+    using System;
+
+    public class BlogContext : DbContext
+    {
+        public DbSet<Post> Posts { get; set; }
+
+        public BlogContext() : base()
+        {
+        }
+
+        public BlogContext(DbContextOptions options) : base(options)
+        {
+        }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            base.OnModelCreating(modelBuilder);
+
+            modelBuilder.Entity<Post>()
+                .HasData(new Post()
+                {
+                    Id = 1,
+                    Title = Guid.NewGuid().ToString(),
+                    Content = Guid.NewGuid().ToString(),
+                    CreatedOn = DateTime.UtcNow,
+                    IsVisible = true
+                }, new Post()
+                {
+                    Id = 2,
+                    Title = Guid.NewGuid().ToString(),
+                    Content = Guid.NewGuid().ToString(),
+                    CreatedOn = DateTime.UtcNow,
+                    IsVisible = false
+                }, new Post()
+                {
+                    Id = 3,
+                    Title = Guid.NewGuid().ToString(),
+                    Content = Guid.NewGuid().ToString(),
+                    CreatedOn = DateTime.UtcNow,
+                    IsVisible = true
+                });
+        }
+    }
+}
diff --git a/sample/FastEndpoints/Source/EFModel/Post.cs b/sample/FastEndpoints/Source/EFModel/Post.cs
@@ -0,0 +1,15 @@
+namespace Panner.AspNetCore.Samples.FastEndpointsNet9.EFModel
+{
+    using System;
+
+    public class Post
+    {
+        public int Id { get; set; }
+        public string Title { get; set; }
+        public string Content { get; set; }
+        public bool IsVisible { get; set; }
+        public int AmtLikes { get; set; }
+        public int AmtComments { get; set; }
+        public DateTime CreatedOn { get; set; }
+    }
+}
diff --git a/sample/FastEndpoints/Source/FastEndpointsNet9.csproj b/sample/FastEndpoints/Source/FastEndpointsNet9.csproj
@@ -11,11 +11,17 @@
         <RootNamespace>Panner.AspNetCore.Samples.FastEndpointsNet9</RootNamespace>
     </PropertyGroup>
 
-    <ItemGroup>
-        <PackageReference Include="FastEndpoints" Version="6.0.0"/>
-        <PackageReference Include="FastEndpoints.Generator" Version="6.0.0" PrivateAssets="all" IncludeAssets="runtime; build; native; contentfiles; analyzers; buildtransitive"/>
-        <PackageReference Include="FastEndpoints.Security" Version="6.0.0"/>
-        <PackageReference Include="FastEndpoints.Swagger" Version="6.0.0"/>
-    </ItemGroup>
+  <ItemGroup>
+      <PackageReference Include="FastEndpoints" Version="6.0.0" />
+      <PackageReference Include="FastEndpoints.Generator" Version="6.0.0" PrivateAssets="all" IncludeAssets="runtime; build; native; contentfiles; analyzers; buildtransitive" />
+      <PackageReference Include="FastEndpoints.Security" Version="6.0.0" />
+      <PackageReference Include="FastEndpoints.Swagger" Version="6.0.0" />
+      <PackageReference Include="Microsoft.EntityFrameworkCore" Version="9.0.6" />
+      <PackageReference Include="Microsoft.EntityFrameworkCore.InMemory" Version="9.0.6" />
+  </ItemGroup>
+
+  <ItemGroup>
+      <ProjectReference Include="..\..\..\src\Panner.AspNetCore.csproj" />
+  </ItemGroup>
 
 </Project>
diff --git a/sample/FastEndpoints/Source/Features/Posts/Endpoint.cs b/sample/FastEndpoints/Source/Features/Posts/Endpoint.cs
@@ -0,0 +1,39 @@
+using Microsoft.EntityFrameworkCore;
+using Panner.AspNetCore.Samples.FastEndpointsNet9.EFModel;
+using Panner.AspNetCore.Samples.FastEndpointsNet9.PannerExtensions;
+
+namespace Posts;
+
+sealed class Endpoint : Endpoint<Request, IEnumerable<Views.Post>>
+{
+    private readonly BlogContext _context;
+
+    public Endpoint(BlogContext context)
+    {
+        _context = context;
+    }
+
+    public override void Configure()
+    {
+        Get("/posts");
+        AllowAnonymous();
+    }
+
+    public override async Task HandleAsync(Request r, CancellationToken c)
+    {
+        _context.Database.EnsureCreated();
+        var result = await _context.Posts
+            .Apply(r.Filters ?? Array.Empty<IFilterParticle<Post>>())
+            .Apply(r.Sorts ?? Array.Empty<ISortParticle<Post>>())
+            .Select(x => new Views.Post
+            {
+                Id = x.Id,
+                Title = x.Title,
+                Content = x.Content,
+                Creation = x.CreatedOn
+            })
+            .ToArrayAsync(c);
+
+        await SendAsync(result, cancellation: c);
+    }
+}
diff --git a/sample/FastEndpoints/Source/Features/Posts/Request.cs b/sample/FastEndpoints/Source/Features/Posts/Request.cs
@@ -0,0 +1,14 @@
+using Microsoft.AspNetCore.Mvc;
+using Panner;
+using Panner.AspNetCore.Samples.FastEndpointsNet9.EFModel;
+
+namespace Posts;
+
+sealed class Request
+{
+    [FromQuery]
+    public IReadOnlyCollection<ISortParticle<Post>>? Sorts { get; set; }
+
+    [FromQuery]
+    public IReadOnlyCollection<IFilterParticle<Post>>? Filters { get; set; }
+}
diff --git a/sample/FastEndpoints/Source/PannerExtensions/PEntityBuilder.Post.IsSortableByPopularity.cs b/sample/FastEndpoints/Source/PannerExtensions/PEntityBuilder.Post.IsSortableByPopularity.cs
@@ -0,0 +1,15 @@
+namespace Panner.AspNetCore.Samples.FastEndpointsNet9.PannerExtensions
+{
+    using global::Panner.AspNetCore.Samples.FastEndpointsNet9.EFModel;
+    using global::Panner.Builders;
+
+    public static partial class PEntityBuilderExtensions
+    {
+        /// <summary>Marks the entity as sortable by popularity.</summary>
+        public static PEntityBuilder<Post> IsSortableByPopularity(this PEntityBuilder<Post> builder)
+        {
+            builder.GetOrCreateGenerator<ISortParticle<Post>, SortPostsByPopularityParticleGenerator>();
+            return builder;
+        }
+    }
+}
diff --git a/sample/FastEndpoints/Source/PannerExtensions/SortPostByPopularityParticle.cs b/sample/FastEndpoints/Source/PannerExtensions/SortPostByPopularityParticle.cs
@@ -0,0 +1,27 @@
+namespace Panner.AspNetCore.Samples.FastEndpointsNet9.PannerExtensions
+{
+    using global::Panner.AspNetCore.Samples.FastEndpointsNet9.EFModel;
+    using System.Linq;
+
+    public class SortPostByPopularityParticle : ISortParticle<Post>
+    {
+        readonly bool Descending;
+
+        public SortPostByPopularityParticle(bool descending)
+        {
+            this.Descending = descending;
+        }
+
+        public IOrderedQueryable<Post> ApplyTo(IOrderedQueryable<Post> source)
+        {
+            if (this.Descending)
+                return source
+                    .ThenByDescending(x => x.AmtLikes)
+                    .ThenByDescending(x => x.AmtComments);
+            else
+                return source
+                    .ThenBy(x => x.AmtLikes)
+                    .ThenBy(x => x.AmtComments);
+        }
+    }
+}
diff --git a/sample/FastEndpoints/Source/PannerExtensions/SortPostsByPopularityParticleGenerator.cs b/sample/FastEndpoints/Source/PannerExtensions/SortPostsByPopularityParticleGenerator.cs
@@ -0,0 +1,22 @@
+using Panner.AspNetCore.Samples.FastEndpointsNet9.EFModel;
+
+namespace Panner.AspNetCore.Samples.FastEndpointsNet9.PannerExtensions
+{
+    public class SortPostsByPopularityParticleGenerator : ISortParticleGenerator<Post>
+    {
+        public bool TryGenerate(IPContext context, string input, out ISortParticle<Post> particle)
+        {
+            var descending = input.StartsWith('-');
+            var remaining = descending ? input.Substring(1) : input;
+
+            if (!remaining.Trim().Equals("Popularity", System.StringComparison.OrdinalIgnoreCase))
+            {
+                particle = null;
+                return false;
+            }
+
+            particle = new SortPostByPopularityParticle(descending);
+            return true;
+        }
+    }
+}
diff --git a/sample/FastEndpoints/Source/Program.cs b/sample/FastEndpoints/Source/Program.cs
@@ -1,10 +1,35 @@
+using Microsoft.EntityFrameworkCore;
+using Panner.AspNetCore.Samples.FastEndpointsNet9.EFModel;
+using Panner.AspNetCore.Samples.FastEndpointsNet9.PannerExtensions;
+using Panner.Builders;
+
 var bld = WebApplication.CreateBuilder(args);
+
 bld.Services
     .AddAuthenticationJwtBearer(s => s.SigningKey = bld.Configuration["Auth:JwtKey"])
     .AddAuthorization()
     .AddFastEndpoints(o => o.SourceGeneratorDiscoveredTypes = DiscoveredTypes.All)
     .SwaggerDocument();
 
+bld.Services.UsePanner(c =>
+{
+    c.Entity<Post>()
+        .IsSortableByPopularity()
+        .Property(x => x.Id, o => o
+            .IsSortableAs(nameof(Views.Post.Id))
+            .IsFilterableAs(nameof(Views.Post.Id))
+        )
+        .Property(x => x.Title, o => o
+            .IsSortableAs(nameof(Views.Post.Title))
+        )
+        .Property(x => x.CreatedOn, o => o
+            .IsSortableAs(nameof(Views.Post.Creation))
+            .IsFilterableAs(nameof(Views.Post.Creation))
+        );
+});
+
+bld.Services.AddDbContext<BlogContext>(o => o.UseInMemoryDatabase("BlogDb"));
+
 var app = bld.Build();
 app.UseAuthentication()
     .UseAuthorization()
@@ -14,4 +39,4 @@
         c.Errors.UseProblemDetails();
     })
     .UseSwaggerGen();
-app.Run();
+app.Run();
diff --git a/sample/FastEndpoints/Source/Views/Post.cs b/sample/FastEndpoints/Source/Views/Post.cs
@@ -0,0 +1,12 @@
+namespace Panner.AspNetCore.Samples.FastEndpointsNet9.Views
+{
+    using System;
+
+    public class Post
+    {
+        public int Id { get; set; }
+        public string Title { get; set; }
+        public string Content { get; set; }
+        public DateTime Creation { get; set; }
+    }
+}
diff --git a/samples/WebAPINet8MinimalFluent/EFModel/BlogContext.cs b/samples/WebAPINet8MinimalFluent/EFModel/BlogContext.cs
@@ -0,0 +1,47 @@
+namespace Panner.AspNetCore.Samples.WebApiNet8MinimalFluent.EFModel
+{
+    using Microsoft.EntityFrameworkCore;
+    using System;
+
+    public class BlogContext : DbContext
+    {
+        public DbSet<Post> Posts { get; set; }
+
+        public BlogContext() : base()
+        {
+        }
+
+        public BlogContext(DbContextOptions options) : base(options)
+        {
+        }
+
+        protected override void OnModelCreating(ModelBuilder modelBuilder)
+        {
+            base.OnModelCreating(modelBuilder);
+
+            modelBuilder.Entity<Post>()
+                .HasData(new Post()
+                {
+                    Id = 1,
+                    Title = Guid.NewGuid().ToString(),
+                    Content = Guid.NewGuid().ToString(),
+                    CreatedOn = DateTime.UtcNow,
+                    IsVisible = true
+                }, new Post()
+                {
+                    Id = 2,
+                    Title = Guid.NewGuid().ToString(),
+                    Content = Guid.NewGuid().ToString(),
+                    CreatedOn = DateTime.UtcNow,
+                    IsVisible = false
+                }, new Post()
+                {
+                    Id = 3,
+                    Title = Guid.NewGuid().ToString(),
+                    Content = Guid.NewGuid().ToString(),
+                    CreatedOn = DateTime.UtcNow,
+                    IsVisible = true
+                });
+        }
+    }
+}
diff --git a/samples/WebAPINet8MinimalFluent/EFModel/Post.cs b/samples/WebAPINet8MinimalFluent/EFModel/Post.cs
@@ -0,0 +1,15 @@
+namespace Panner.AspNetCore.Samples.WebApiNet8MinimalFluent.EFModel
+{
+    using System;
+
+    public class Post
+    {
+        public int Id { get; set; }
+        public string Title { get; set; }
+        public string Content { get; set; }
+        public bool IsVisible { get; set; }
+        public int AmtLikes { get; set; }
+        public int AmtComments { get; set; }
+        public DateTime CreatedOn { get; set; }
+    }
+}
diff --git a/...es/WebAPINet8MinimalFluent/PannerExtensions/PEntityBuilder.Post.IsSortableByPopularity.cs b/...es/WebAPINet8MinimalFluent/PannerExtensions/PEntityBuilder.Post.IsSortableByPopularity.cs
@@ -0,0 +1,15 @@
+namespace Panner.AspNetCore.Samples.WebApiNet8MinimalFluent.PannerExtensions
+{
+    using global::Panner.AspNetCore.Samples.WebApiNet8MinimalFluent.EFModel;
+    using global::Panner.Builders;
+
+    public static partial class PEntityBuilderExtensions
+    {
+        /// <summary>Marks the entity as sortable by popularity.</summary>
+        public static PEntityBuilder<Post> IsSortableByPopularity(this PEntityBuilder<Post> builder)
+        {
+            builder.GetOrCreateGenerator<ISortParticle<Post>, SortPostsByPopularityParticleGenerator>();
+            return builder;
+        }
+    }
+}
diff --git a/samples/WebAPINet8MinimalFluent/PannerExtensions/SortPostByPopularityParticle.cs b/samples/WebAPINet8MinimalFluent/PannerExtensions/SortPostByPopularityParticle.cs
@@ -0,0 +1,27 @@
+namespace Panner.AspNetCore.Samples.WebApiNet8MinimalFluent.PannerExtensions
+{
+    using global::Panner.AspNetCore.Samples.WebApiNet8MinimalFluent.EFModel;
+    using System.Linq;
+
+    public class SortPostByPopularityParticle : ISortParticle<Post>
+    {
+        readonly bool Descending;
+
+        public SortPostByPopularityParticle(bool descending)
+        {
+            this.Descending = descending;
+        }
+
+        public IOrderedQueryable<Post> ApplyTo(IOrderedQueryable<Post> source)
+        {
+            if (this.Descending)
+                return source
+                    .ThenByDescending(x => x.AmtLikes)
+                    .ThenByDescending(x => x.AmtComments);
+            else
+                return source
+                    .ThenBy(x => x.AmtLikes)
+                    .ThenBy(x => x.AmtComments);
+        }
+    }
+}
diff --git a/samples/WebAPINet8MinimalFluent/PannerExtensions/SortPostsByPopularityParticleGenerator.cs b/samples/WebAPINet8MinimalFluent/PannerExtensions/SortPostsByPopularityParticleGenerator.cs
@@ -0,0 +1,22 @@
+using Panner.AspNetCore.Samples.WebApiNet8MinimalFluent.EFModel;
+
+namespace Panner.AspNetCore.Samples.WebApiNet8MinimalFluent.PannerExtensions
+{
+    public class SortPostsByPopularityParticleGenerator : ISortParticleGenerator<Post>
+    {
+        public bool TryGenerate(IPContext context, string input, out ISortParticle<Post> particle)
+        {
+            var descending = input.StartsWith('-');
+            var remaining = descending ? input.Substring(1) : input;
+
+            if (!remaining.Trim().Equals("Popularity", System.StringComparison.OrdinalIgnoreCase))
+            {
+                particle = null;
+                return false;
+            }
+
+            particle = new SortPostByPopularityParticle(descending);
+            return true;
+        }
+    }
+}