Add ability to filter responses (#2)

* Add ability to filter responses

* Add ability to filter responses

Author: cleeve

src/Responses/AbstractResponse.php

@@ -1,7 +1,10 @@
 <?php
 namespace Cubex\ApiTransport\Responses;
 
+use Cubex\ApiTransport\Exceptions\GenericApiException;
 use Packaged\Helpers\Objects;
+use function array_filter;
+use function is_array;
 
 abstract class AbstractResponse implements ApiResponse
 {
@@ -16,4 +19,23 @@ public function hydrate(object $response): static
 
     return $this;
   }
+
+  /**
+   * @param string   $property
+   * @param callable $func
+   *
+   * @return $this
+   * @throws GenericApiException
+   */
+  public function filterClone(string $property, callable $func): static
+  {
+    if (!isset($this->$property) || !is_array($this->$property))
+    {
+      throw new GenericApiException();
+    }
+
+    $resp = clone $this;
+    $resp->$property = array_filter($this->$property, $func);
+    return $resp;
+  }
 }