Added hasBank methods and improved Currency linkage

Expanded `BankController` with multiple `hasBank` overloads for better account-checking flexibility. Updated `Currency` to include `getHolder`, improving association tracking. Adjusted wrappers to align with these changes.

Author: NonSwag

build.gradle.kts

@@ -5,7 +5,7 @@ plugins {
 }
 
 group = "net.thenextlvl.services"
-version = "3.0.0-pre4"
+version = "3.0.0-pre5"
 
 java {
     toolchain.languageVersion = JavaLanguageVersion.of(21)

plugin/src/main/java/net/thenextlvl/service/wrapper/service/BankServiceWrapper.java

@@ -85,12 +85,30 @@ public CompletableFuture<Boolean> deleteBank(UUID uuid, @Nullable World world) {
 
     @Override
     public Optional<Bank> getBank(String name) {
+        if (!economy.getBanks().contains(name)) return Optional.empty();
         return Optional.of(new WrappedBank(name, null, economy, plugin));
     }
 
+    @Override
+    public Optional<Bank> getBank(OfflinePlayer player, @Nullable World world) {
+        return economy.getBanks().stream().filter(bank ->
+                economy.isBankOwner(bank, player).transactionSuccess()
+        ).findAny().flatMap(this::getBank);
+    }
+
     @Override
     public Optional<Bank> getBank(UUID uuid, @Nullable World world) {
-        return Optional.empty();
+        return getBank(plugin.getServer().getOfflinePlayer(uuid), world);
+    }
+
+    @Override
+    public boolean hasBank(OfflinePlayer player, @Nullable World world) {
+        return economy.getBanks().stream().anyMatch(bank -> economy.isBankOwner(bank, player).transactionSuccess());
+    }
+
+    @Override
+    public boolean hasBank(UUID uuid, @Nullable World world) {
+        return hasBank(plugin.getServer().getOfflinePlayer(uuid), world);
     }
 
     @Override

plugin/src/main/java/net/thenextlvl/service/wrapper/service/EconomyServiceWrapper.java

@@ -114,7 +114,7 @@ private static class WrappedCurrencyHolder implements CurrencyHolder {
         private final Currency currency;
 
         private WrappedCurrencyHolder(Economy economy) {
-            this.currency = new WrappedCurrency(economy);
+            this.currency = new WrappedCurrency(this, economy);
         }
 
         @Override

plugin/src/main/java/net/thenextlvl/service/wrapper/service/model/WrappedCurrency.java

@@ -3,6 +3,7 @@
 import net.kyori.adventure.text.Component;
 import net.milkbowl.vault.economy.Economy;
 import net.thenextlvl.service.api.economy.currency.Currency;
+import net.thenextlvl.service.api.economy.currency.CurrencyHolder;
 import org.jetbrains.annotations.Unmodifiable;
 import org.jspecify.annotations.NullMarked;
 import org.jspecify.annotations.Nullable;
@@ -15,10 +16,17 @@
 
 @NullMarked
 public class WrappedCurrency implements Currency {
+    private final CurrencyHolder holder;
     private final Economy economy;
 
-    public WrappedCurrency(Economy economy) {
+    public WrappedCurrency(CurrencyHolder holder, Economy economy) {
         this.economy = economy;
+        this.holder = holder;
+    }
+
+    @Override
+    public CurrencyHolder getHolder() {
+        return holder;
     }
 
     @Override

src/main/java/net/thenextlvl/service/api/economy/bank/BankController.java

@@ -28,7 +28,7 @@ public interface BankController extends Controller {
      */
     @Contract(pure = true)
     CurrencyHolder getCurrencyHolder();
-    
+
     /**
      * Creates a bank for the specified player with the given name.
      * <p>
@@ -335,6 +335,46 @@ default Optional<Bank> getBank(UUID uuid) {
      */
     Optional<Bank> getBank(UUID uuid, @Nullable World world);
 
+    /**
+     * Checks if the specified player has a bank account.
+     *
+     * @param player the player to check for an associated bank account
+     * @return {@code true} if the player has a bank account, otherwise {@code false}
+     */
+    default boolean hasBank(OfflinePlayer player) {
+        return hasBank(player, null);
+    }
+
+    /**
+     * Checks if the specified player has a bank account in the given world.
+     *
+     * @param player the player to check for an associated bank account
+     * @param world  the world in which to check for the bank account
+     * @return {@code true} if the player has a bank account in the specified world, otherwise {@code false}
+     */
+    default boolean hasBank(OfflinePlayer player, @Nullable World world) {
+        return hasBank(player.getUniqueId(), world);
+    }
+
+    /**
+     * Checks if the specified uuid is associated with a bank account.
+     *
+     * @param uuid the uuid of a player to check for an associated bank account
+     * @return {@code true} if the uuid is associated with a bank account, otherwise {@code false}
+     */
+    default boolean hasBank(UUID uuid) {
+        return hasBank(uuid, null);
+    }
+
+    /**
+     * Checks if the specified uuid is associated with a bank account in the given world.
+     *
+     * @param uuid  the uuid of a player to check for an associated bank account
+     * @param world the world in which to check for the bank account
+     * @return {@code true} if the uuid is associated with a bank account in the specified world, otherwise {@code false}
+     */
+    boolean hasBank(UUID uuid, @Nullable World world);
+
     /**
      * Determines whether the controller supports handling of multiple worlds.
      *

src/main/java/net/thenextlvl/service/api/economy/currency/Currency.java

@@ -21,6 +21,14 @@
  */
 @NullMarked
 public interface Currency {
+    /**
+     * Retrieves the {@code CurrencyHolder} associated with this currency.
+     *
+     * @return the {@code CurrencyHolder} instance that manages this currency
+     */
+    @Contract(pure = true)
+    CurrencyHolder getHolder();
+
     /**
      * Retrieves the name of the currency.
      *
@@ -121,7 +129,7 @@ default Component format(Number amount, Audience audience) {
      * @return a {@code Builder} instance initialized with the properties of the current {@code Currency}
      */
     Builder toBuilder();
-    
+
     /**
      * A builder interface for constructing instances of {@link Currency}.
      * The {@code Builder} allows for the configuration of currency properties such as