Added balances

Author: Lawondyss

src/Config.php

@@ -34,7 +34,8 @@ private function __construct(
     public string $authTokenUri,
     public string $adaaApiKey,
     public string $adaaUri,
-  ) {}
+  ) {
+  }
 
 
   public static function createFromDotEnv(SplFileInfo $filePath): self

src/Entity/Balance.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace SpojeNet\KbAccountsApi\Entity;
+
+class Balance
+{
+  public function __construct(
+    public readonly BalanceType $type,
+    public readonly Amount $amount,
+    public readonly CreditDebit $creditDebitIndicator,
+    public readonly \DateTimeImmutable $validAt,
+  ) {
+  }
+}

src/Entity/BalanceType.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace SpojeNet\KbAccountsApi\Entity;
+
+enum BalanceType: string
+{
+  /**
+   * Opening balance of the day = closing balance of the previous day, i.e. day - 1.
+   * Are only the booked transactions, what the day opens with, closed with the previous day's accounting.
+   */
+  case Opening = 'PREVIOUSLY_CLOSED_BOOK';
+
+  /**
+   * This type of balance is not used.
+   */
+  case Booked = 'CLOSING_BOOKED';
+
+  /**
+   * Includes everything, even unbooked transactions = current balance available to you.
+   */
+  case Available = 'CLOSING_AVAILABLE';
+}

src/KbClient.php

@@ -13,6 +13,7 @@
 use SplFileInfo;
 use SpojeNet\KbAccountsApi\Entity\Account;
 use SpojeNet\KbAccountsApi\Entity\ApplicationReq;
+use SpojeNet\KbAccountsApi\Entity\Balance;
 use SpojeNet\KbAccountsApi\Entity\ClientReq;
 use SpojeNet\KbAccountsApi\Entity\ClientRes;
 use SpojeNet\KbAccountsApi\Entity\Statement;
@@ -27,6 +28,7 @@
 use SpojeNet\KbAccountsApi\Utils\Random;
 
 use function array_filter;
+use function array_map;
 use function array_unique;
 use function base64_decode;
 use function base64_encode;
@@ -398,6 +400,21 @@ public function statementPdf(string $accessToken, StatementPdfSelection $selecti
     );
   }
 
+
+  /**
+   * @throws KbClientException
+   * @return Balance[]
+   */
+  public function balances(string $accessToken, string $accountId): array
+  {
+    $data = $this->sendAdaaRequest(
+      accessToken: $accessToken,
+      endpoint: "/accounts/{$accountId}/balances",
+    );
+
+    return array_map(static fn (array $item) => DtoMapper::map(Balance::class, $item), $data);
+  }
+
   /* Utilities */
 
   /**