feat(ItemRepository): add pagination support for item queries with enchantments, lore, and flags

Author: TheMeinerLP

src/main/java/net/onelitefeather/vulpes/api/repository/ItemRepository.java

@@ -25,33 +25,42 @@ public interface ItemRepository extends PageableRepository<ItemEntity, UUID> {
      * @param id the unique identifier of the item
      * @return a map of enchantment names and their levels associated with the item
      */
-    @Query("SELECT e FROM items i JOIN i.enchantments e WHERE i.id = :id")
-    Map<String, Short> findEnchantmentsById(UUID id);
+    @Query(value = "SELECT e FROM items i JOIN i.enchantments e WHERE i.id = :id",
+            countQuery = "SELECT count(e) FROM items i JOIN i.enchantments e WHERE i.id = :id"
+    )
+    Map<String, Short> findEnchantmentsById(UUID id, Pageable pageable);
 
     /**
      * Retrieves the lore associated with an item by its ID.
      *
      * @param id the unique identifier of the item
      * @return a list of lore strings associated with the item
      */
-    @Query("SELECT l FROM items i JOIN i.lore l WHERE i.id = :id")
-    List<String> findLoreById(UUID id);
+    @Query(value = "SELECT l FROM items i JOIN i.lore l WHERE i.id = :id",
+            countQuery = "SELECT count(l) FROM items i JOIN i.lore l WHERE i.id = :id"
+    )
+    List<String> findLoreById(UUID id, Pageable pageable);
 
     /**
      * Retrieves the flags associated with an item by its ID.
      *
      * @param id the unique identifier of the item
      * @return a list of flags associated with the item
      */
-    @Query("SELECT f FROM items i JOIN i.flags f WHERE i.id = :id")
-    List<String> findFlagsById(UUID id);
+    @Query(value = "SELECT f FROM items i JOIN i.flags f WHERE i.id = :id",
+            countQuery = "SELECT count(f) FROM items i JOIN i.flags f WHERE i.id = :id"
+    )
+    List<String> findFlagsById(UUID id, Pageable pageable);
 
 
     /**
      * Retrieves all items along with their associated enchantments, lore, and flags.
      *
      * @return a list of all ItemEntity objects with their enchantments, lore, and flags
      */
-    @Query("SELECT i FROM items i LEFT JOIN FETCH i.enchantments LEFT JOIN FETCH i.lore LEFT JOIN FETCH i.flags")
-    List<ItemEntity> findAllWithFetches();
+    @Query(
+            value = "SELECT i FROM items i LEFT JOIN FETCH i.enchantments LEFT JOIN FETCH i.lore LEFT JOIN FETCH i.flags",
+            countQuery = "SELECT count(i) FROM items i"
+    )
+    List<ItemEntity> findAllWithFetches(Pageable pageable);
 }