Added parcel->cancel() method

Author: imbue

src/Endpoints/AbstractEndpoint.php

@@ -94,7 +94,7 @@ protected function restRead($id, array $filters): AbstractResource
      * @return AbstractResource|null
      * @throws ApiException
      */
-    protected function restDelete($id, array $body = []): AbstractResource
+    protected function restDelete($id, array $body = []): ?AbstractResource
     {
         if (empty($id)) {
             throw new ApiException('Invalid resource id.');

src/Endpoints/ParcelEndpoint.php

@@ -4,7 +4,9 @@
 
 use Imbue\SendCloud\Exceptions\ApiException;
 use Imbue\SendCloud\Resources\Collections\ParcelCollection;
+use Imbue\SendCloud\Resources\GenericStatus;
 use Imbue\SendCloud\Resources\Parcel;
+use Imbue\SendCloud\Resources\ResourceFactory;
 
 class ParcelEndpoint extends AbstractEndpoint
 {
@@ -59,4 +61,20 @@ public function create(array $data = [])
     {
         return $this->restCreate($data);
     }
+
+    /**
+     * @param array $data
+     * @return GenericStatus
+     * @throws ApiException
+     */
+    public function cancel(string $id)
+    {
+        $result = $this->client->performHttpCall(
+            self::REST_CREATE,
+            "{$this->getResourcePath()}/{$id}/cancel",
+            $this->parseRequestBody([])
+        );
+
+        return ResourceFactory::createFromApiResult($result, new GenericStatus($this->client));
+    }
 }

src/Resources/GenericStatus.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace Imbue\SendCloud\Resources;
+
+class GenericStatus extends AbstractResource
+{
+    /** @var string */
+    public $status;
+    /** @var string */
+    public $message;
+}