add forcePay method

Author: rez1dent3

src/Interfaces/Customer.php

@@ -9,18 +9,27 @@ interface Customer extends Wallet
 
     /**
      * @param Product $product
+     * @param bool $force
      * @return Transfer
      * @throws
      */
-    public function pay(Product $product): Transfer;
+    public function pay(Product $product, bool $force = false): Transfer;
 
     /**
      * @param Product $product
+     * @param bool $force
      * @return null|Transfer
      * @throws
      */
     public function safePay(Product $product): ?Transfer;
 
+    /**
+     * @param Product $product
+     * @return Transfer
+     * @throws
+     */
+    public function forcePay(Product $product): Transfer;
+
     /**
      * @param Product $product
      * @return null|Transfer
@@ -29,15 +38,23 @@ public function paid(Product $product): ?Transfer;
 
     /**
      * @param Product $product
+     * @param bool $force
      * @return bool
      * @throws
      */
-    public function refund(Product $product): bool;
+    public function refund(Product $product, bool $force = false): bool;
+
+    /**
+     * @param Product $product
+     * @param bool $force
+     * @return bool
+     */
+    public function safeRefund(Product $product, bool $force = false): bool;
 
     /**
      * @param Product $product
      * @return bool
      */
-    public function safeRefund(Product $product): bool;
+    public function forceRefund(Product $product): bool;
 
 }

src/Interfaces/Product.php

@@ -7,10 +7,11 @@ interface Product extends Wallet
 
     /**
      * @param Customer $customer
+     * @param bool $force
      *
      * @return bool
      */
-    public function canBuy(Customer $customer): bool;
+    public function canBuy(Customer $customer, bool $force = false): bool;
 
     /**
      * @return int

src/Traits/CanBePaid.php

@@ -16,31 +16,47 @@ trait CanBePaid
 
     /**
      * @param Product $product
+     * @param bool $force
      * @return Transfer
      * @throws
      */
-    public function pay(Product $product): Transfer
+    public function pay(Product $product, bool $force = false): Transfer
     {
-        if (!$product->canBuy($this)) {
+        if (!$product->canBuy($this, $force)) {
             throw new ProductEnded('The product is out of stock');
         }
 
+        if ($force) {
+            return $this->forceTransfer($product, $product->getAmountProduct(), $product->getMetaProduct());
+        }
+
         return $this->transfer($product, $product->getAmountProduct(), $product->getMetaProduct());
     }
 
     /**
      * @param Product $product
+     * @param bool $force
      * @return Transfer|null
      */
-    public function safePay(Product $product): ?Transfer
+    public function safePay(Product $product, bool $force = false): ?Transfer
     {
         try {
-            return $this->pay($product);
+            return $this->pay($product, $force);
         } catch (\Throwable $throwable) {
             return null;
         }
     }
 
+    /**
+     * @param Product $product
+     * @return Transfer
+     * @throws
+     */
+    public function forcePay(Product $product): Transfer
+    {
+        return $this->pay($product, true);
+    }
+
     /**
      * @param Product $product
      * @return null|Transfer
@@ -101,6 +117,7 @@ public function safeRefund(Product $product, bool $force = false): bool
     /**
      * @param Product $product
      * @return bool
+     * @throws
      */
     public function forceRefund(Product $product): bool
     {

tests/Models/Item.php

@@ -27,12 +27,19 @@ class Item extends Model implements Product
 
     /**
      * @param Customer $customer
+     * @param bool $force
      *
      * @return bool
      */
-    public function canBuy(Customer $customer): bool
+    public function canBuy(Customer $customer, bool $force = false): bool
     {
-        return $this->quantity > 0 && !$customer->paid($this);
+        $result = $this->quantity > 0;
+
+        if ($force) {
+            return $result;
+        }
+
+        return $result && !$customer->paid($this);
     }
 
     /**

tests/ProductTest.php

@@ -2,6 +2,7 @@
 
 namespace Bavix\Wallet\Test;
 
+use Bavix\Wallet\Models\Transaction;
 use Bavix\Wallet\Test\Models\Buyer;
 use Bavix\Wallet\Test\Models\Item;
 
@@ -13,6 +14,10 @@ class ProductTest extends TestCase
      */
     public function testPay(): void
     {
+        /**
+         * @var Buyer $buyer
+         * @var Item $product
+         */
         $buyer = factory(Buyer::class)->create();
         $product = factory(Item::class)->create([
             'quantity' => 1,
@@ -22,7 +27,30 @@ public function testPay(): void
         $buyer->deposit($product->price);
 
         $this->assertEquals($buyer->balance, $product->price);
-        $this->assertNotNull($buyer->pay($product));
+        $transfer = $buyer->pay($product);
+        $this->assertNotNull($transfer);
+
+        /**
+         * @var Transaction $withdraw
+         * @var Transaction $deposit
+         */
+        $withdraw = $transfer->withdraw;
+        $deposit = $transfer->deposit;
+
+        $this->assertInstanceOf(Transaction::class, $withdraw);
+        $this->assertInstanceOf(Transaction::class, $deposit);
+
+        $this->assertInstanceOf(Buyer::class, $withdraw->payable);
+        $this->assertInstanceOf(Item::class, $deposit->payable);
+
+        $this->assertEquals($buyer->getKey(), $withdraw->payable->getKey());
+        $this->assertEquals($product->getKey(), $deposit->payable->getKey());
+
+        $this->assertInstanceOf(Buyer::class, $transfer->from);
+        $this->assertInstanceOf(Item::class, $transfer->to);
+
+        $this->assertEquals($buyer->getKey(), $transfer->from->getKey());
+        $this->assertEquals($product->getKey(), $transfer->to->getKey());
 
         $this->assertEquals($buyer->balance, 0);
         $this->assertNull($buyer->safePay($product));
@@ -33,6 +61,10 @@ public function testPay(): void
      */
     public function testRefund(): void
     {
+        /**
+         * @var Buyer $buyer
+         * @var Item $product
+         */
         $buyer = factory(Buyer::class)->create();
         $product = factory(Item::class)->create([
             'quantity' => 1,
@@ -115,4 +147,27 @@ public function testOutOfStock(): void
         $buyer->pay($product);
     }
 
+    /**
+     * @return void
+     */
+    public function testForcePay(): void
+    {
+        /**
+         * @var Buyer $buyer
+         * @var Item $product
+         */
+        $buyer = factory(Buyer::class)->create();
+        $product = factory(Item::class)->create([
+            'quantity' => 1,
+        ]);
+
+        $this->assertEquals($buyer->balance, 0);
+        $buyer->forcePay($product);
+
+        $this->assertEquals($buyer->balance, -$product->price);
+
+        $buyer->deposit(-$buyer->balance);
+        $this->assertEquals($buyer->balance, 0);
+    }
+
 }