Merge branch 'sale-data-type' of https://github.com/bladeroot/php-billing into sale-data-type

Author: bladeroot

src/sale/Sale.php

@@ -17,6 +17,7 @@
 use hiqdev\php\billing\Exception\InvariantException;
 use hiqdev\php\billing\plan\PlanInterface;
 use hiqdev\php\billing\target\TargetInterface;
+use yii\helpers\Json;
 
 /**
  * Sale.
@@ -52,15 +53,15 @@ class Sale implements SaleInterface
 
     protected ?DateTimeImmutable $closeTime = null;
 
-    protected ?array $data = null;
+    protected ?string $data = null;
 
     public function __construct(
         $id,
         TargetInterface $target,
         CustomerInterface $customer,
         ?PlanInterface $plan = null,
         ?DateTimeImmutable $time = null,
-        ?array $data = null,
+        ?string $data = null,
     ) {
         $this->id = $id;
         $this->target = $target;
@@ -129,9 +130,9 @@ public function setId($id)
         $this->id = $id;
     }
 
-    public function getData()
+    public function getData(): ?array
     {
-        return $this->data;
+        return !empty($this->data) ? Json::decode($this->data, true) : null;
     }
 
     public function jsonSerialize(): array

src/sale/SaleCreationDto.php

@@ -28,4 +28,6 @@ class SaleCreationDto
     public $closeTime;
 
     public $data;
+
+    public $reason;
 }

src/sale/SaleFactory.php

@@ -23,7 +23,7 @@ class SaleFactory implements SaleFactoryInterface
      */
     public function create(SaleCreationDto $dto)
     {
-        $sale = new Sale($dto->id, $dto->target, $dto->customer, $dto->plan, $dto->time);
+        $sale = new Sale($dto->id, $dto->target, $dto->customer, $dto->plan, $dto->time, $dto->data);
 
         if ($dto->closeTime !== null) {
             $sale->close($dto->closeTime);

src/sale/SaleInterface.php

@@ -62,9 +62,9 @@ public function getTime();
     public function getCloseTime(): ?DateTimeImmutable;
 
     /**
-     * @return string|array|null
+     * @return array|null
      */
-    public function getData();
+    public function getData(): ?array;
 
     /**
      * @param DateTimeImmutable $time