[11.x] Add interfaces for High performance api handles

deptrac.yaml

@@ -171,12 +171,13 @@ parameters:
       - Model
 
     ApiQuery:
+      - Api
       - Model
       - Contract
 
     Api:
       - Model
-      - ApiQuery
+      - Contract
       - InternalException
 
     ApiHandler:

src/External/Api/TransactionQuery.php

@@ -5,14 +5,9 @@
 namespace Bavix\Wallet\External\Api;
 
 use Bavix\Wallet\Interfaces\Wallet;
-use Bavix\Wallet\Models\Transaction;
 
-final readonly class TransactionQuery
+final readonly class TransactionQuery implements TransactionQueryInterface
 {
-    public const TYPE_DEPOSIT = Transaction::TYPE_DEPOSIT;
-
-    public const TYPE_WITHDRAW = Transaction::TYPE_WITHDRAW;
-
     /**
      * @param self::TYPE_DEPOSIT|self::TYPE_WITHDRAW $type
      * @param array<mixed>|null $meta

src/External/Api/TransactionQueryHandler.php

@@ -26,19 +26,19 @@ public function __construct(
     public function apply(array $objects): array
     {
         $wallets = $this->assistantService->getWallets(
-            array_map(static fn (TransactionQuery $query): Wallet => $query->getWallet(), $objects),
+            array_map(static fn (TransactionQueryInterface $query): Wallet => $query->getWallet(), $objects),
         );
 
         $values = array_map(
-            fn (TransactionQuery $query) => match ($query->getType()) {
-                TransactionQuery::TYPE_DEPOSIT => $this->prepareService->deposit(
+            fn (TransactionQueryInterface $query) => match ($query->getType()) {
+                TransactionQueryInterface::TYPE_DEPOSIT => $this->prepareService->deposit(
                     $query->getWallet(),
                     $query->getAmount(),
                     $query->getMeta(),
                     $query->isConfirmed(),
                     $query->getUuid(),
                 ),
-                TransactionQuery::TYPE_WITHDRAW => $this->prepareService->withdraw(
+                TransactionQueryInterface::TYPE_WITHDRAW => $this->prepareService->withdraw(
                     $query->getWallet(),
                     $query->getAmount(),
                     $query->getMeta(),

src/External/Api/TransactionQueryHandlerInterface.php

@@ -17,7 +17,7 @@ interface TransactionQueryHandlerInterface
      * If there is a need to check the balance, then you need to wrap the method call in the AtomicServiceInterface
      * and check the correctness of the balance manually.
      *
-     * @param non-empty-array<TransactionQuery> $objects
+     * @param non-empty-array<TransactionQueryInterface> $objects
      *
      * @return non-empty-array<string, Transaction>
      *

src/External/Api/TransactionQueryInterface.php

@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Bavix\Wallet\External\Api;
+
+use Bavix\Wallet\Interfaces\Wallet;
+use Bavix\Wallet\Models\Transaction;
+
+interface TransactionQueryInterface
+{
+    public const TYPE_DEPOSIT = Transaction::TYPE_DEPOSIT;
+
+    public const TYPE_WITHDRAW = Transaction::TYPE_WITHDRAW;
+
+    /**
+     * @return self::TYPE_DEPOSIT|self::TYPE_WITHDRAW
+     */
+    public function getType(): string;
+
+    public function getWallet(): Wallet;
+
+    public function getAmount(): float|int|string;
+
+    /**
+     * @return array<mixed>|null
+     */
+    public function getMeta(): ?array;
+
+    public function isConfirmed(): bool;
+
+    public function getUuid(): ?string;
+}

src/External/Api/TransferQuery.php

@@ -7,7 +7,7 @@
 use Bavix\Wallet\External\Contracts\ExtraDtoInterface;
 use Bavix\Wallet\Interfaces\Wallet;
 
-final readonly class TransferQuery
+final readonly class TransferQuery implements TransferQueryInterface
 {
     /**
      * @param array<mixed>|ExtraDtoInterface|null $meta

src/External/Api/TransferQueryHandler.php

@@ -27,11 +27,11 @@ public function __construct(
     public function apply(array $objects): array
     {
         $wallets = $this->assistantService->getWallets(
-            array_map(static fn (TransferQuery $query): Wallet => $query->getFrom(), $objects),
+            array_map(static fn (TransferQueryInterface $query): Wallet => $query->getFrom(), $objects),
         );
 
         $values = array_map(
-            fn (TransferQuery $query) => $this->prepareService->transferLazy(
+            fn (TransferQueryInterface $query) => $this->prepareService->transferLazy(
                 $query->getFrom(),
                 $query->getTo(),
                 Transfer::STATUS_TRANSFER,

src/External/Api/TransferQueryHandlerInterface.php

@@ -17,7 +17,7 @@ interface TransferQueryHandlerInterface
      * If there is a need to check the balance, then you need to wrap the method call in the AtomicServiceInterface
      * and check the correctness of the balance manually.
      *
-     * @param non-empty-array<TransferQuery> $objects
+     * @param non-empty-array<TransferQueryInterface> $objects
      *
      * @return non-empty-array<string, Transfer>
      *

src/External/Api/TransferQueryInterface.php

@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Bavix\Wallet\External\Api;
+
+use Bavix\Wallet\External\Contracts\ExtraDtoInterface;
+use Bavix\Wallet\Interfaces\Wallet;
+
+interface TransferQueryInterface
+{
+    public function getFrom(): Wallet;
+
+    public function getTo(): Wallet;
+
+    public function getAmount(): float|int|string;
+
+    /**
+     * @return array<mixed>|ExtraDtoInterface|null
+     */
+    public function getMeta(): array|ExtraDtoInterface|null;
+}