Feature/Added wakeup method to create instances without call explicitly the constructor

[othercodes]

Creating an instance with new keyword will execute the logic inside the __constructor() but using ::wakeup() will create the instance, and fill the properties without executing the logic in the __constructor().

So, having and aggregate Order that registers the domain event OrderCreated in the constructor:

final class Order implements Aggregate
{
    use IsAggregate;

    private OrderId $id;
    private PaymentStatus $status;
    private array $orderLines;

    public function __construct(OrderId $id, PaymentStatus $status, array $orderLines)
    {
        $this->initialize([$id, $status, $orderLines]);
        $this->registerDomainEvent(new OrderCreated($this->id()->value()));
    }

    protected function invariantEachOrderLineMustBeTypeOfOrderLine(): bool
    {
        foreach ($this->orderLines as $orderLine) {
            if (!($orderLine instanceof OrderLine)) {
                throw new InvariantViolation("All order lines must be type of OrderLine");
            }
        }

        return true;
    }

    public static function create(OrderId $id, PaymentStatus $status, array $orderLines): self
    {
        return new self($id, $status, $orderLines);
    }
}

we can do:

// OrderCreated domain event is register since is register in __constructor().
$a = new Order(...) 

// aggregate constructor is NOT called so the domain event is not registered,
// initialize() is called so the invariants are also checked.
$a = Order::wakeup(...) 

This makes the usage of new more semantic as we are creating a REAL new instance of the Aggregate not just creating an object, we may need to register some domain events on the creation of the Aggregate.

[codecov]

Codecov Report

❗ No coverage uploaded for pull request base (develop@7daec89). Click here to learn what that means.
The diff coverage is n/a.

@@            Coverage Diff             @@
##             develop      #26   +/-   ##
==========================================
  Coverage           ?   91.29%           
  Complexity         ?      200           
==========================================
  Files              ?       26           
  Lines              ?      448           
  Branches           ?        0           
==========================================
  Hits               ?      409           
  Misses             ?       39           
  Partials           ?        0           

Flag	Coverage Δ	Complexity Δ
unittests	91.29% <0.00%> (?)	0.00% <0.00%> (?%)

Flags with carried forward coverage won't be shown. Click here to find out more.

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 7daec89...0945023. Read the comment docs.