feat(v1): adding new failed, __toString & toPsrResponse to Response (#22)

Author: CodeDredd

.github/release-drafter.yml

@@ -1,4 +1,4 @@
-name-template: 'v$NEXT_PATCH_VERSION 🌈'
+name-template: 'v$NEXT_PATCH_VERSION'
 tag-template: 'v$NEXT_PATCH_VERSION'
 categories:
   - title: '🚀 Features'
@@ -11,9 +11,14 @@ categories:
       - 'bugfix'
       - 'bug'
   - title: '🧰 Maintenance'
-    label: 'chore'
+    labels:
+      - 'chore'
+      - 'documentation'
+      - 'dependencies'
+  - title: ':boom: BREAKING CHANGE'
+    label: 'BREAKING CHANGE'
 change-template: '- $TITLE @$AUTHOR (#$NUMBER)'
 template: |
   ## Changes
 
-  $CHANGES
+  $CHANGES

src/Client/Response.php

@@ -67,13 +67,24 @@ public static function fromSoapFault(\SoapFault $soapFault)
     /**
      * Get the full SOAP enveloppe response.
      *
+     * @deprecated removed in v2 and replaced by toPsrResponse
      * @return string
      */
     public function getResponse(): string
     {
         return $this->response;
     }
 
+    /**
+     * Get the underlying PSR response for the response.
+     *
+     * @return \Psr\Http\Message\ResponseInterface
+     */
+    public function toPsrResponse()
+    {
+        return $this->response;
+    }
+
     /**
      * Get the JSON decoded body of the response as an object.
      *
@@ -133,6 +144,16 @@ public function ok()
         return $this->status() === 200;
     }
 
+    /**
+     * Determine if the response indicates a client or server error occurred.
+     *
+     * @return bool
+     */
+    public function failed()
+    {
+        return $this->serverError() || $this->clientError();
+    }
+
     /**
      * Determine if the response was a redirect.
      *
@@ -152,7 +173,7 @@ public function redirect()
      */
     public function throw()
     {
-        if ($this->serverError() || $this->clientError()) {
+        if ($this->failed()) {
             throw new RequestException($this);
         }
 
@@ -242,6 +263,16 @@ public function offsetUnset($offset)
         throw new LogicException('Response data may not be mutated using array access.');
     }
 
+    /**
+     * Get the body of the response.
+     *
+     * @return string
+     */
+    public function __toString()
+    {
+        return $this->body();
+    }
+
     /**
      * Dynamically proxy other methods to the underlying response.
      *