SearchLanguagesQuery

backend/src/Logitar.Cms.Contracts/Languages/LanguageSort.cs

@@ -0,0 +1,11 @@
+namespace Logitar.Cms.Contracts.Languages;
+
+public enum LanguageSort
+{
+  Code,
+  CreatedOn,
+  DisplayName,
+  EnglishName,
+  NativeName,
+  UpdatedOn
+}

backend/src/Logitar.Cms.Contracts/Languages/LanguageSortOption.cs

@@ -0,0 +1,20 @@
+using Logitar.Cms.Contracts.Search;
+
+namespace Logitar.Cms.Contracts.Languages;
+
+public record LanguageSortOption : SortOption
+{
+  public new LanguageSort Field
+  {
+    get => Enum.Parse<LanguageSort>(base.Field);
+    set => base.Field = value.ToString();
+  }
+
+  public LanguageSortOption() : this(LanguageSort.DisplayName)
+  {
+  }
+
+  public LanguageSortOption(LanguageSort field, bool isDescending = false) : base(field.ToString(), isDescending)
+  {
+  }
+}

backend/src/Logitar.Cms.Contracts/Languages/SearchLanguagesPayload.cs

@@ -0,0 +1,8 @@
+using Logitar.Cms.Contracts.Search;
+
+namespace Logitar.Cms.Contracts.Languages;
+
+public record SearchLanguagesPayload : SearchPayload
+{
+  public new List<LanguageSortOption> Sort { get; set; } = [];
+}

backend/src/Logitar.Cms.Contracts/Search/SearchOperator.cs

@@ -0,0 +1,7 @@
+namespace Logitar.Cms.Contracts.Search;
+
+public enum SearchOperator
+{
+  And = 0,
+  Or = 1
+}

backend/src/Logitar.Cms.Contracts/Search/SearchPayload.cs

@@ -0,0 +1,12 @@
+namespace Logitar.Cms.Contracts.Search;
+
+public record SearchPayload
+{
+  public List<Guid> Ids { get; set; } = [];
+  public TextSearch Search { get; set; } = new();
+
+  public List<SortOption> Sort { get; set; } = [];
+
+  public int Skip { get; set; }
+  public int Limit { get; set; }
+}

backend/src/Logitar.Cms.Contracts/Search/SearchResults.cs

@@ -0,0 +1,25 @@
+namespace Logitar.Cms.Contracts.Search;
+
+public record SearchResults<T>
+{
+  public List<T> Items { get; set; }
+  public long Total { get; set; }
+
+  public SearchResults() : this([])
+  {
+  }
+
+  public SearchResults(IEnumerable<T> items) : this(items, items.LongCount())
+  {
+  }
+
+  public SearchResults(long total) : this([], total)
+  {
+  }
+
+  public SearchResults(IEnumerable<T> items, long total)
+  {
+    Items = items.ToList();
+    Total = total;
+  }
+}

backend/src/Logitar.Cms.Contracts/Search/SearchTerm.cs

@@ -0,0 +1,15 @@
+namespace Logitar.Cms.Contracts.Search;
+
+public record SearchTerm
+{
+  public string Value { get; set; }
+
+  public SearchTerm() : this(string.Empty)
+  {
+  }
+
+  public SearchTerm(string value)
+  {
+    Value = value;
+  }
+}

backend/src/Logitar.Cms.Contracts/Search/SortOption.cs

@@ -0,0 +1,17 @@
+namespace Logitar.Cms.Contracts.Search;
+
+public record SortOption
+{
+  public string Field { get; set; }
+  public bool IsDescending { get; set; }
+
+  public SortOption() : this(string.Empty)
+  {
+  }
+
+  public SortOption(string field, bool isDescending = false)
+  {
+    Field = field;
+    IsDescending = isDescending;
+  }
+}

backend/src/Logitar.Cms.Contracts/Search/TextSearch.cs

@@ -0,0 +1,17 @@
+namespace Logitar.Cms.Contracts.Search;
+
+public record TextSearch
+{
+  public List<SearchTerm> Terms { get; set; }
+  public SearchOperator Operator { get; set; }
+
+  public TextSearch() : this([])
+  {
+  }
+
+  public TextSearch(IEnumerable<SearchTerm> terms, SearchOperator @operator = SearchOperator.And)
+  {
+    Terms = terms.ToList();
+    Operator = @operator;
+  }
+}

backend/src/Logitar.Cms.Core/Languages/ILanguageQuerier.cs

@@ -1,4 +1,5 @@
 using Logitar.Cms.Contracts.Languages;
+using Logitar.Cms.Contracts.Search;
 
 namespace Logitar.Cms.Core.Languages;
 
@@ -11,4 +12,6 @@ public interface ILanguageQuerier
   Task<LanguageModel?> ReadAsync(Guid id, CancellationToken cancellationToken = default);
   Task<LanguageModel?> ReadAsync(string locale, CancellationToken cancellationToken = default);
   Task<LanguageModel> ReadDefaultAsync(CancellationToken cancellationToken = default);
+
+  Task<SearchResults<LanguageModel>> SearchAsync(SearchLanguagesPayload payload, CancellationToken cancellationToken = default);
 }

backend/src/Logitar.Cms.Core/Languages/Queries/SearchLanguagesQuery.cs

@@ -0,0 +1,22 @@
+using Logitar.Cms.Contracts.Languages;
+using Logitar.Cms.Contracts.Search;
+using MediatR;
+
+namespace Logitar.Cms.Core.Languages.Queries;
+
+public record SearchLanguagesQuery(SearchLanguagesPayload Payload) : IRequest<SearchResults<LanguageModel>>;
+
+internal class SearchLanguagesQueryHandler : IRequestHandler<SearchLanguagesQuery, SearchResults<LanguageModel>>
+{
+  private readonly ILanguageQuerier _languageQuerier;
+
+  public SearchLanguagesQueryHandler(ILanguageQuerier languageQuerier)
+  {
+    _languageQuerier = languageQuerier;
+  }
+
+  public async Task<SearchResults<LanguageModel>> Handle(SearchLanguagesQuery query, CancellationToken cancellationToken)
+  {
+    return await _languageQuerier.SearchAsync(query.Payload, cancellationToken);
+  }
+}

backend/tests/Logitar.Cms.Core.UnitTests/Languages/Queries/SearchLanguagesQueryHandlerTests.cs

@@ -0,0 +1,34 @@
+using Logitar.Cms.Contracts.Languages;
+using Logitar.Cms.Contracts.Search;
+using Moq;
+
+namespace Logitar.Cms.Core.Languages.Queries;
+
+[Trait(Traits.Category, Categories.Unit)]
+public class SearchLanguagesQueryHandlerTests
+{
+  private readonly CancellationToken _cancellationToken = default;
+
+  private readonly Mock<ILanguageQuerier> _languageQuerier = new();
+
+  private readonly SearchLanguagesQueryHandler _handler;
+
+  public SearchLanguagesQueryHandlerTests()
+  {
+    _handler = new(_languageQuerier.Object);
+  }
+
+  [Fact(DisplayName = "It should return the correct search results.")]
+  public async Task It_should_return_the_correct_search_results()
+  {
+    SearchLanguagesPayload payload = new();
+
+    SearchResults<LanguageModel> results = new();
+    _languageQuerier.Setup(x => x.SearchAsync(payload, _cancellationToken)).ReturnsAsync(results);
+
+    SearchLanguagesQuery query = new(payload);
+
+    SearchResults<LanguageModel> searchResults = await _handler.Handle(query, _cancellationToken);
+    Assert.Same(results, searchResults);
+  }
+}