⭐ Parsing exceptions to include message stubs

Author: cdosoftei

src/Exception/SIPException.php

@@ -6,6 +6,7 @@
 
 namespace RTCKit\SIP\Exception;
 
+use RTCKit\SIP\Message;
 use DomainException;
 use Throwable;
 
@@ -14,4 +15,26 @@
 */
 class SIPException extends DomainException implements Throwable
 {
+    /** @var ?Message Partial parsed message, before the exception was encountered */
+    private ?Message $stub = null;
+
+    /**
+     * Assigns a message stub to the current exception
+     *
+     * @param Message $stub Partial message
+     */
+    public function setStub(Message $stub): void
+    {
+        $this->stub = $stub;
+    }
+
+    /**
+     * Retrieve's exception's stub, if any
+     *
+     * @return ?Message Partial message
+     */
+    public function getStub(): ?Message
+    {
+        return $this->stub;
+    }
 }