Add custom ordering functionality.

src/ApiFilter/ApiQuery.php

@@ -22,6 +22,7 @@ class ApiQuery
 
     /**
      * @param list<CustomFilterInterface> $customFilters
+     * @param list<CustomOrderInterface> $customOrders
      *
      * @throws ORMException
      */
@@ -32,6 +33,7 @@ public function __construct(
         #[Deprecated] protected ?CustomFilterInterface $customFilter = null,
         protected bool $fetchOneAdditionalRecord = false,
         protected array $customFilters = [],
+        protected array $customOrders = [],
     ) {
         if ($this->customFilter instanceof CustomFilterInterface && empty($this->customFilters)) {
             $this->customFilters = [$this->customFilter];
@@ -84,6 +86,10 @@ private function applyOrders(): void
         foreach ($this->apiParams->getOrder() as $field => $direction) {
             $this->dqb->addOrderBy('t.' . $field, $direction);
         }
+
+        foreach ($this->customOrders as $customOrder) {
+            $customOrder->apply($this->dqb, $this->apiParams);
+        }
     }
 
     /**

src/ApiFilter/CustomOrderInterface.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace AnzuSystems\CommonBundle\ApiFilter;
+
+use Doctrine\ORM\QueryBuilder;
+
+interface CustomOrderInterface
+{
+    public function apply(QueryBuilder $dqb, ApiParams $apiParams): QueryBuilder;
+}

src/Repository/AbstractAnzuRepository.php

@@ -9,6 +9,7 @@
 use AnzuSystems\CommonBundle\ApiFilter\ApiQuery;
 use AnzuSystems\CommonBundle\ApiFilter\ApiResponseList;
 use AnzuSystems\CommonBundle\ApiFilter\CustomFilterInterface;
+use AnzuSystems\CommonBundle\ApiFilter\CustomOrderInterface;
 use AnzuSystems\Contracts\Entity\AnzuUser;
 use AnzuSystems\Contracts\Entity\Interfaces\UserTrackingInterface;
 use Closure;
@@ -64,13 +65,15 @@ public function getAllByIdIndexed(int | string ...$id): ArrayCollection
 
     /**
      * @param list<CustomFilterInterface> $customFilters
+     * @param list<CustomOrderInterface> $customOrders
      *
      * @throws ORMException
      */
     public function findByApiParams(
         ApiParams $apiParams,
         #[Deprecated] ?CustomFilterInterface $customFilter = null,
         array $customFilters = [],
+        array $customOrders = [],
         ?Closure $mapDataFn = null,
     ): ApiResponseList {
         if ($customFilter instanceof CustomFilterInterface && empty($customFilters)) {
@@ -81,7 +84,8 @@ public function findByApiParams(
             entityManager: $this->getEntityManager(),
             metadata: $this->getClassMetadata(),
             apiParams: $apiParams,
-            customFilters: $customFilters
+            customFilters: $customFilters,
+            customOrders: $customOrders,
         );
 
         $data = $apiQuery->getData();
@@ -104,6 +108,7 @@ public function findByApiParams(
 
     /**
      * @param list<CustomFilterInterface> $customFilters
+     * @param list<CustomOrderInterface> $customOrders
      * @param ?CustomFilterInterface $customFilter Deprecated
      *
      * @throws ORMException
@@ -112,6 +117,7 @@ public function findByApiParamsWithInfiniteListing(
         ApiParams $apiParams,
         #[Deprecated] ?CustomFilterInterface $customFilter = null,
         array $customFilters = [],
+        array $customOrders = [],
         ?Closure $mapDataFn = null,
     ): ApiInfiniteResponseList {
         if ($customFilter instanceof CustomFilterInterface && empty($customFilters)) {
@@ -124,6 +130,7 @@ public function findByApiParamsWithInfiniteListing(
             apiParams: $apiParams,
             fetchOneAdditionalRecord: true,
             customFilters: $customFilters,
+            customOrders: $customOrders,
         );
         $data = $apiQuery->getData();
         $totalCount = $apiParams->getLimit() + $apiParams->getOffset() + 1;