ExtraDtoInterface

Author: rez1dent3

config/config.php

@@ -4,6 +4,8 @@
 
 use Bavix\Wallet\Internal\Assembler\AvailabilityDtoAssembler;
 use Bavix\Wallet\Internal\Assembler\BalanceUpdatedEventAssembler;
+use Bavix\Wallet\Internal\Assembler\ExtraDtoAssembler;
+use Bavix\Wallet\Internal\Assembler\OptionDtoAssembler;
 use Bavix\Wallet\Internal\Assembler\TransactionDtoAssembler;
 use Bavix\Wallet\Internal\Assembler\TransactionQueryAssembler;
 use Bavix\Wallet\Internal\Assembler\TransferDtoAssembler;
@@ -126,6 +128,8 @@
     'assemblers' => [
         'availability' => AvailabilityDtoAssembler::class,
         'balance_updated_event' => BalanceUpdatedEventAssembler::class,
+        'extra' => ExtraDtoAssembler::class,
+        'option' => OptionDtoAssembler::class,
         'transaction' => TransactionDtoAssembler::class,
         'transfer_lazy' => TransferLazyDtoAssembler::class,
         'transfer' => TransferDtoAssembler::class,

src/Interfaces/Exchangeable.php

@@ -6,6 +6,7 @@
 
 use Bavix\Wallet\Exceptions\BalanceIsEmpty;
 use Bavix\Wallet\Exceptions\InsufficientFunds;
+use Bavix\Wallet\Internal\Dto\ExtraDtoInterface;
 use Bavix\Wallet\Internal\Exceptions\ExceptionInterface;
 use Bavix\Wallet\Internal\Exceptions\LockProviderNotFoundException;
 use Bavix\Wallet\Internal\Exceptions\RecordNotFoundException;
@@ -26,12 +27,12 @@ interface Exchangeable
      * @throws TransactionFailedException
      * @throws ExceptionInterface
      */
-    public function exchange(Wallet $to, $amount, ?array $meta = null): Transfer;
+    public function exchange(Wallet $to, $amount, array|ExtraDtoInterface|null $meta = null): Transfer;
 
     /**
      * @param int|string $amount
      */
-    public function safeExchange(Wallet $to, $amount, ?array $meta = null): ?Transfer;
+    public function safeExchange(Wallet $to, $amount, array|ExtraDtoInterface|null $meta = null): ?Transfer;
 
     /**
      * @param int|string $amount
@@ -42,5 +43,5 @@ public function safeExchange(Wallet $to, $amount, ?array $meta = null): ?Transfe
      * @throws TransactionFailedException
      * @throws ExceptionInterface
      */
-    public function forceExchange(Wallet $to, $amount, ?array $meta = null): Transfer;
+    public function forceExchange(Wallet $to, $amount, array|ExtraDtoInterface|null $meta = null): Transfer;
 }

src/Interfaces/Wallet.php

@@ -7,6 +7,7 @@
 use Bavix\Wallet\Exceptions\AmountInvalid;
 use Bavix\Wallet\Exceptions\BalanceIsEmpty;
 use Bavix\Wallet\Exceptions\InsufficientFunds;
+use Bavix\Wallet\Internal\Dto\ExtraDtoInterface;
 use Bavix\Wallet\Internal\Exceptions\ExceptionInterface;
 use Bavix\Wallet\Internal\Exceptions\LockProviderNotFoundException;
 use Bavix\Wallet\Internal\Exceptions\TransactionFailedException;
@@ -64,12 +65,12 @@ public function forceWithdraw($amount, ?array $meta = null, bool $confirmed = tr
      * @throws TransactionFailedException
      * @throws ExceptionInterface
      */
-    public function transfer(self $wallet, $amount, ?array $meta = null): Transfer;
+    public function transfer(self $wallet, $amount, array|null|ExtraDtoInterface $meta = null): Transfer;
 
     /**
      * @param int|string $amount
      */
-    public function safeTransfer(self $wallet, $amount, ?array $meta = null): ?Transfer;
+    public function safeTransfer(self $wallet, $amount, array|null|ExtraDtoInterface $meta = null): ?Transfer;
 
     /**
      * @param int|string $amount
@@ -80,7 +81,7 @@ public function safeTransfer(self $wallet, $amount, ?array $meta = null): ?Trans
      * @throws TransactionFailedException
      * @throws ExceptionInterface
      */
-    public function forceTransfer(self $wallet, $amount, ?array $meta = null): Transfer;
+    public function forceTransfer(self $wallet, $amount, array|null|ExtraDtoInterface $meta = null): Transfer;
 
     /**
      * @param int|string $amount

src/Interfaces/WalletFloat.php

@@ -7,6 +7,7 @@
 use Bavix\Wallet\Exceptions\AmountInvalid;
 use Bavix\Wallet\Exceptions\BalanceIsEmpty;
 use Bavix\Wallet\Exceptions\InsufficientFunds;
+use Bavix\Wallet\Internal\Dto\ExtraDtoInterface;
 use Bavix\Wallet\Internal\Exceptions\ExceptionInterface;
 use Bavix\Wallet\Internal\Exceptions\LockProviderNotFoundException;
 use Bavix\Wallet\Internal\Exceptions\TransactionFailedException;
@@ -62,12 +63,12 @@ public function forceWithdrawFloat($amount, ?array $meta = null, bool $confirmed
      * @throws TransactionFailedException
      * @throws ExceptionInterface
      */
-    public function transferFloat(Wallet $wallet, $amount, ?array $meta = null): Transfer;
+    public function transferFloat(Wallet $wallet, $amount, array|ExtraDtoInterface|null $meta = null): Transfer;
 
     /**
      * @param float|string $amount
      */
-    public function safeTransferFloat(Wallet $wallet, $amount, ?array $meta = null): ?Transfer;
+    public function safeTransferFloat(Wallet $wallet, $amount, array|ExtraDtoInterface|null $meta = null): ?Transfer;
 
     /**
      * @param float|string $amount
@@ -78,7 +79,7 @@ public function safeTransferFloat(Wallet $wallet, $amount, ?array $meta = null):
      * @throws TransactionFailedException
      * @throws ExceptionInterface
      */
-    public function forceTransferFloat(Wallet $wallet, $amount, ?array $meta = null): Transfer;
+    public function forceTransferFloat(Wallet $wallet, $amount, array|ExtraDtoInterface|null $meta = null): Transfer;
 
     /**
      * @param float|string $amount

src/Internal/Assembler/ExtraDtoAssembler.php

@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Bavix\Wallet\Internal\Assembler;
+
+use Bavix\Wallet\Internal\Dto\ExtraDto;
+use Bavix\Wallet\Internal\Dto\ExtraDtoInterface;
+
+final class ExtraDtoAssembler implements ExtraDtoAssemblerInterface
+{
+    public function __construct(private OptionDtoAssemblerInterface $optionDtoAssembler)
+    {
+    }
+
+    public function create(ExtraDtoInterface|array|null $data): ExtraDtoInterface
+    {
+        if ($data instanceof ExtraDtoInterface) {
+            return $data;
+        }
+
+        $option = $this->optionDtoAssembler->create($data);
+
+        return new ExtraDto($option, $option);
+    }
+}

src/Internal/Assembler/ExtraDtoAssemblerInterface.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Bavix\Wallet\Internal\Assembler;
+
+use Bavix\Wallet\Internal\Dto\ExtraDtoInterface;
+
+interface ExtraDtoAssemblerInterface
+{
+    public function create(array|ExtraDtoInterface|null $data): ExtraDtoInterface;
+}

src/Internal/Assembler/OptionDtoAssembler.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Bavix\Wallet\Internal\Assembler;
+
+use Bavix\Wallet\Internal\Dto\OptionDto;
+use Bavix\Wallet\Internal\Dto\OptionDtoInterface;
+
+final class OptionDtoAssembler implements OptionDtoAssemblerInterface
+{
+    public function create(array|null $data): OptionDtoInterface
+    {
+        return new OptionDto($data);
+    }
+}

src/Internal/Assembler/OptionDtoAssemblerInterface.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Bavix\Wallet\Internal\Assembler;
+
+use Bavix\Wallet\Internal\Dto\OptionDtoInterface;
+
+interface OptionDtoAssemblerInterface
+{
+    public function create(array|null $data): OptionDtoInterface;
+}

src/Internal/Dto/ExtraDto.php

@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Bavix\Wallet\Internal\Dto;
+
+/** @internal */
+final class ExtraDto implements ExtraDtoInterface
+{
+    public function __construct(
+        private OptionDtoInterface $deposit,
+        private OptionDtoInterface $withdraw
+    ) {
+    }
+
+    public function getDepositExtra(): OptionDtoInterface
+    {
+        return $this->deposit;
+    }
+
+    public function getWithdrawExtra(): OptionDtoInterface
+    {
+        return $this->withdraw;
+    }
+}

src/Internal/Dto/ExtraDtoInterface.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Bavix\Wallet\Internal\Dto;
+
+interface ExtraDtoInterface
+{
+    public function getDepositExtra(): OptionDtoInterface;
+
+    public function getWithdrawExtra(): OptionDtoInterface;
+}