feat: add attributes

Author: vaened

src/Attributes.php

@@ -0,0 +1,40 @@
+<?php
+/**
+ * @author enea dhack <enea.so@live.com>
+ */
+
+declare(strict_types=1);
+
+namespace Vaened\SwiftCart;
+
+final class Attributes
+{
+    public function __construct(private array $attributes)
+    {
+    }
+
+    public static function are(array $attributes): self
+    {
+        return new self($attributes);
+    }
+
+    public static function empty(): self
+    {
+        return new self([]);
+    }
+
+    public function has(string $name): bool
+    {
+        return isset($this->attributes[$name]);
+    }
+
+    public function __get(string $name): mixed
+    {
+        return $this->attributes[$name] ?? null;
+    }
+
+    public function __set(string $name, mixed $value): void
+    {
+        $this->attributes[$name] = $value;
+    }
+}

src/Concerns/HasAttributes.php

@@ -0,0 +1,23 @@
+<?php
+/**
+ * @author enea dhack <enea.so@live.com>
+ */
+
+declare(strict_types=1);
+
+namespace Vaened\SwiftCart\Concerns;
+
+trait HasAttributes
+{
+    private mixed $attributes = null;
+
+    public function attributes(): mixed
+    {
+        return $this->attributes;
+    }
+
+    protected function setAttributes(mixed $attributes): void
+    {
+        $this->attributes = $attributes;
+    }
+}

src/Entities/Attributable.php

@@ -0,0 +1,13 @@
+<?php
+/**
+ * @author enea dhack <enea.so@live.com>
+ */
+
+declare(strict_types=1);
+
+namespace Vaened\SwiftCart\Entities;
+
+interface Attributable
+{
+    public function attributes(): mixed;
+}

src/Items/CartItem.php

@@ -12,14 +12,15 @@
 use Vaened\PriceEngine\Cashier;
 use Vaened\PriceEngine\Money\Amount;
 use Vaened\PriceEngine\TotalSummary;
-use Vaened\SwiftCart\Entities\Chargeable;
-use Vaened\SwiftCart\Entities\Discountable;
-use Vaened\SwiftCart\Entities\Identifiable;
-use Vaened\SwiftCart\Entities\Tradable;
+use Vaened\SwiftCart\Attributes;
+use Vaened\SwiftCart\Concerns\HasAttributes;
+use Vaened\SwiftCart\Entities\{Attributable, Chargeable, Discountable, Identifiable, Tradable};
 use Vaened\SwiftCart\SwiftCartConfig;
 
 abstract class CartItem implements Identifiable
 {
+    use HasAttributes;
+
     private readonly Cashier $cashier;
 
     public function __construct(
@@ -28,6 +29,7 @@ public function __construct(
         Taxes                       $taxes = new Taxes([]),
     )
     {
+        $this->setAttributes($tradable instanceof Attributable ? $tradable->attributes() : Attributes::empty());
         $this->cashier = $this->createCashier(
             $tradable->amount(),
             $quantity,