Implement suppressions API (#258) (#264)

* Implement suppressions API (#258)

* Fix annotation issues and use alternate pagination method

src/Mailgun/Api/Suppressions.php

@@ -0,0 +1,73 @@
+<?php
+
+/*
+ * Copyright (C) 2013-2016 Mailgun
+ *
+ * This software may be modified and distributed under the terms
+ * of the MIT license. See the LICENSE file for details.
+ */
+
+namespace Mailgun\Api;
+
+use Http\Client\HttpClient;
+use Mailgun\Deserializer\ResponseDeserializer;
+use Mailgun\RequestBuilder;
+
+/**
+ * @see https://documentation.mailgun.com/api-suppressions.html
+ *
+ * @author Sean Johnson <sean@mailgun.com>
+ */
+class Suppressions
+{
+    /**
+     * @var HttpClient
+     */
+    private $httpClient;
+
+    /**
+     * @var RequestBuilder
+     */
+    private $requestBuilder;
+
+    /**
+     * @var ResponseDeserializer
+     */
+    private $deserializer;
+
+    /**
+     * @param HttpClient           $httpClient
+     * @param RequestBuilder       $requestBuilder
+     * @param ResponseDeserializer $deserializer
+     */
+    public function __construct(HttpClient $httpClient, RequestBuilder $requestBuilder, ResponseDeserializer $deserializer)
+    {
+        $this->httpClient = $httpClient;
+        $this->requestBuilder = $requestBuilder;
+        $this->deserializer = $deserializer;
+    }
+
+    /**
+     * @return Suppressions\Bounce
+     */
+    public function bounces()
+    {
+        return new Suppressions\Bounce($this->httpClient, $this->requestBuilder, $this->deserializer);
+    }
+
+    /**
+     * @return Suppressions\Complaint
+     */
+    public function complaints()
+    {
+        return new Suppressions\Complaint($this->httpClient, $this->requestBuilder, $this->deserializer);
+    }
+
+    /**
+     * @return Suppressions\Unsubscribe
+     */
+    public function unsubscribes()
+    {
+        return new Suppressions\Unsubscribe($this->httpClient, $this->requestBuilder, $this->deserializer);
+    }
+}

src/Mailgun/Api/Suppressions/Bounce.php

@@ -0,0 +1,111 @@
+<?php
+
+/*
+ * Copyright (C) 2013-2016 Mailgun
+ *
+ * This software may be modified and distributed under the terms
+ * of the MIT license. See the LICENSE file for details.
+ */
+
+namespace Mailgun\Api;
+
+use Mailgun\Assert;
+use Mailgun\Resource\Api\Suppressions\Bounce\CreateResponse;
+use Mailgun\Resource\Api\Suppressions\Bounce\DeleteResponse;
+use Mailgun\Resource\Api\Suppressions\Bounce\IndexResponse;
+use Mailgun\Resource\Api\Suppressions\Bounce\ShowResponse;
+
+/**
+ * @see https://documentation.mailgun.com/api-suppressions.html#bounces
+ *
+ * @author Sean Johnson <sean@mailgun.com>
+ */
+class Bounce extends HttpApi
+{
+    use Pagination;
+
+    /**
+     * @param string $domain Domain to list bounces for
+     * @param int    $limit  optional
+     *
+     * @return IndexResponse
+     */
+    public function index($domain, $limit = 100)
+    {
+        Assert::stringNotEmpty($domain);
+        Assert::range($limit, 1, 10000, '"Limit" parameter must be between 1 and 10000');
+
+        $params = [
+            'limit' => $limit,
+        ];
+
+        $response = $this->httpGet(sprintf('/v3/%s/bounces', $domain), $params);
+
+        return $this->safeDeserialize($response, IndexResponse::class);
+    }
+
+    /**
+     * @param string $domain  Domain to show bounce from
+     * @param string $address Bounce address to show
+     *
+     * @return ShowResponse
+     */
+    public function show($domain, $address)
+    {
+        Assert::stringNotEmpty($domain);
+        Assert::stringNotEmpty($address);
+
+        $response = $this->httpGet(sprintf('/v3/%s/bounces/%s', $domain, $address));
+
+        return $this->safeDeserialize($response, ShowResponse::class);
+    }
+
+    /**
+     * @param string $domain  Domain to create a bounce for
+     * @param string $address Address to create a bounce for
+     * @param array  $params  optional
+     *
+     * @return CreateResponse
+     */
+    public function create($domain, $address, array $params = [])
+    {
+        Assert::stringNotEmpty($domain);
+        Assert::stringNotEmpty($address);
+
+        $params['address'] = $address;
+
+        $response = $this->httpPost(sprintf('/v3/%s/bounces', $domain), $params);
+
+        return $this->safeDeserialize($response, CreateResponse::class);
+    }
+
+    /**
+     * @param string $domain  Domain to delete a bounce for
+     * @param string $address Bounce address to delete
+     *
+     * @return DeleteResponse
+     */
+    public function delete($domain, $address)
+    {
+        Assert::stringNotEmpty($domain);
+        Assert::stringNotEmpty($address);
+
+        $response = $this->httpDelete(sprintf('/v3/%s/bounces/%s', $domain, $address));
+
+        return $this->safeDeserialize($response, DeleteResponse::class);
+    }
+
+    /**
+     * @param string $domain Domain to delete all bounces for
+     *
+     * @return DeleteResponse
+     */
+    public function deleteAll($domain)
+    {
+        Assert::stringNotEmpty($domain);
+
+        $response = $this->httpDelete(sprintf('/v3/%s/bounces', $domain));
+
+        return $this->safeDeserialize($response, DeleteResponse::class);
+    }
+}

src/Mailgun/Api/Suppressions/Complaint.php

@@ -0,0 +1,110 @@
+<?php
+
+/*
+ * Copyright (C) 2013-2016 Mailgun
+ *
+ * This software may be modified and distributed under the terms
+ * of the MIT license. See the LICENSE file for details.
+ */
+
+namespace Mailgun\Api;
+
+use Mailgun\Assert;
+use Mailgun\Resource\Api\Suppressions\Complaint\CreateResponse;
+use Mailgun\Resource\Api\Suppressions\Complaint\DeleteResponse;
+use Mailgun\Resource\Api\Suppressions\Complaint\IndexResponse;
+use Mailgun\Resource\Api\Suppressions\Complaint\ShowResponse;
+
+/**
+ * @see https://documentation.mailgun.com/api-suppressions.html#complaints
+ *
+ * @author Sean Johnson <sean@mailgun.com>
+ */
+class Complaint extends HttpApi
+{
+    use Pagination;
+
+    /**
+     * @param string $domain Domain to get complaints for
+     * @param int    $limit  optional
+     *
+     * @return IndexResponse
+     */
+    public function index($domain, $limit = 100)
+    {
+        Assert::stringNotEmpty($domain);
+        Assert::range($limit, 1, 10000, 'Limit parameter must be between 1 and 10000');
+
+        $params = [
+            'limit' => $limit,
+        ];
+
+        $response = $this->httpGet(sprintf('/v3/%s/complaints', $domain), $params);
+
+        return $this->safeDeserialize($response, IndexResponse::class);
+    }
+
+    /**
+     * @param string $domain  Domain to show complaint for
+     * @param string $address Complaint address
+     *
+     * @return ShowResponse
+     */
+    public function show($domain, $address)
+    {
+        Assert::stringNotEmpty($domain);
+        Assert::stringNotEmpty($address);
+        $response = $this->httpGet(sprintf('/v3/%s/complaints/%s', $domain, $address));
+
+        return $this->safeDeserialize($response, ShowResponse::class);
+    }
+
+    /**
+     * @param string $domain  Domain to create complaint for
+     * @param string $address Complaint address
+     * @param array  $params  optional
+     *
+     * @return CreateResponse
+     */
+    public function create($domain, $address, $code = null, $error = null, $createdAt = null)
+    {
+        Assert::stringNotEmpty($domain);
+        Assert::stringNotEmpty($address);
+
+        $params['address'] = $address;
+
+        $response = $this->httpPost(sprintf('/v3/%s/complaints', $domain), $params);
+
+        return $this->safeDeserialize($response, CreateResponse::class);
+    }
+
+    /**
+     * @param string $domain  Domain to delete complaint for
+     * @param string $address Complaint address
+     *
+     * @return DeleteResponse
+     */
+    public function delete($domain, $address)
+    {
+        Assert::stringNotEmpty($domain);
+        Assert::stringNotEmpty($address);
+
+        $response = $this->httpDelete(sprintf('/v3/%s/complaints/%s', $domain, $address));
+
+        return $this->safeDeserialize($response, DeleteResponse::class);
+    }
+
+    /**
+     * @param string $domain Domain to delete all bounces for
+     *
+     * @return DeleteResponse
+     */
+    public function deleteAll($domain)
+    {
+        Assert::stringNotEmpty($domain);
+
+        $response = $this->httpDelete(sprintf('/v3/%s/complaints', $domain));
+
+        return $this->safeDeserialize($response, DeleteResponse::class);
+    }
+}

src/Mailgun/Api/Suppressions/Unsubscribe.php

@@ -0,0 +1,111 @@
+<?php
+
+/*
+ * Copyright (C) 2013-2016 Mailgun
+ *
+ * This software may be modified and distributed under the terms
+ * of the MIT license. See the LICENSE file for details.
+ */
+
+namespace Mailgun\Api;
+
+use Mailgun\Assert;
+use Mailgun\Resource\Api\Suppressions\Unsubscribe\CreateResponse;
+use Mailgun\Resource\Api\Suppressions\Unsubscribe\DeleteResponse;
+use Mailgun\Resource\Api\Suppressions\Unsubscribe\IndexResponse;
+use Mailgun\Resource\Api\Suppressions\Unsubscribe\ShowResponse;
+
+/**
+ * @see https://documentation.mailgun.com/api-suppressions.html#unsubscribes
+ *
+ * @author Sean Johnson <sean@mailgun.com>
+ */
+class Unsubscribe extends HttpApi
+{
+    use Pagination;
+
+    /**
+     * @param string $domain Domain to get unsubscribes for
+     * @param int    $limit  optional
+     *
+     * @return IndexResponse
+     */
+    public function index($domain, $limit = 100)
+    {
+        Assert::stringNotEmpty($domain);
+        Assert::range($limit, 1, 10000, 'Limit parameter must be between 1 and 10000');
+
+        $params = [
+            'limit' => $limit,
+        ];
+
+        $response = $this->httpGet(sprintf('/v3/%s/unsubscribes', $domain), $params);
+
+        return $this->safeDeserialize($response, IndexResponse::class);
+    }
+
+    /**
+     * @param string $domain  Domain to show unsubscribe for
+     * @param string $address Unsubscribe address
+     *
+     * @return ShowResponse
+     */
+    public function show($domain, $address)
+    {
+        Assert::stringNotEmpty($domain);
+        Assert::stringNotEmpty($address);
+
+        $response = $this->httpGet(sprintf('/v3/%s/unsubscribes/%s', $domain, $address));
+
+        return $this->safeDeserialize($response, ShowResponse::class);
+    }
+
+    /**
+     * @param string $domain  Domain to create unsubscribe for
+     * @param string $address Unsubscribe address
+     * @param array  $params  optional
+     *
+     * @return CreateResponse
+     */
+    public function create($domain, $address, array $params = [])
+    {
+        Assert::stringNotEmpty($domain);
+        Assert::stringNotEmpty($address);
+
+        $params['address'] = $address;
+
+        $response = $this->httpPost(sprintf('/v3/%s/unsubscribes', $domain), $params);
+
+        return $this->safeDeserialize($response, CreateResponse::class);
+    }
+
+    /**
+     * @param string $domain  Domain to delete unsubscribe for
+     * @param string $address Unsubscribe address
+     *
+     * @return DeleteResponse
+     */
+    public function delete($domain, $address)
+    {
+        Assert::stringNotEmpty($domain);
+        Assert::stringNotEmpty($address);
+
+        $response = $this->httpDelete(sprintf('/v3/%s/unsubscribes/%s', $domain, $address));
+
+        return $this->safeDeserialize($response, DeleteResponse::class);
+    }
+
+    /**
+     * @param string $domain Domain to delete all unsubscribes for
+     *
+     * @return DeleteResponse
+     */
+    public function deleteAll($domain)
+    {
+        Assert::stringNotEmpty($domain);
+
+        $response = $this->httpDelete(sprintf('/v3/%s/unsubscribes', $domain));
+
+        return $this->safeDeserialize($response, DeleteResponse::class);
+    }
+}

src/Mailgun/Mailgun.php

@@ -300,4 +300,12 @@ class Mailgun
     {
         return new Api\Message($this->httpClient, $this->requestBuilder, $this->deserializer);
     }
+
+    /**
+     * @return Api\Suppressions
+     */
+    public function suppressions()
+    {
+        return new Api\Suppressions($this->httpClient, $this->requestBuilder, $this->deserializer);
+    }
 }

src/Mailgun/Resource/Api/Suppressions/BaseResponse.php

@@ -0,0 +1,69 @@
+<?php
+
+/*
+ * Copyright (C) 2013-2016 Mailgun
+ *
+ * This software may be modified and distributed under the terms
+ * of the MIT license. See the LICENSE file for details.
+ */
+
+namespace Mailgun\Resource\Api\Suppressions;
+
+use Mailgun\Resource\ApiResponse;
+
+/**
+ * Serves only as an abstract base for suppressions API code.
+ *
+ * @author Sean Johnson <sean@mailgun.com>
+ */
+abstract class BaseResponse implements ApiResponse
+{
+    /**
+     * @var string
+     */
+    private $address;
+
+    /**
+     * @var string
+     */
+    private $message;
+
+    /**
+     * @param string $address
+     * @param string $message
+     */
+    private function __construct($address, $message)
+    {
+        $this->address = $address;
+        $this->message = $message;
+    }
+
+    /**
+     * @param array $data
+     *
+     * @return BaseResponse
+     */
+    public static function create(array $data)
+    {
+        $address = isset($data['address']) ? $data['address'] : '';
+        $message = isset($data['message']) ? $data['message'] : '';
+
+        return new static($address, $message);
+    }
+
+    /**
+     * @return string
+     */
+    public function getAddress()
+    {
+        return $this->address;
+    }
+
+    /**
+     * @return string
+     */
+    public function getMessage()
+    {
+        return $this->message;
+    }
+}

src/Mailgun/Resource/Api/Suppressions/Bounce/CreateResponse.php

@@ -0,0 +1,19 @@
+<?php
+
+/*
+ * Copyright (C) 2013-2016 Mailgun
+ *
+ * This software may be modified and distributed under the terms
+ * of the MIT license. See the LICENSE file for details.
+ */
+
+namespace Mailgun\Resource\Api\Suppressions\Bounce;
+
+use Mailgun\Resource\Api\Suppressions\BaseResponse;
+
+/**
+ * @author Sean Johnson <sean@mailgun.com>
+ */
+final class CreateResponse extends BaseResponse
+{
+}

src/Mailgun/Resource/Api/Suppressions/Bounce/DeleteResponse.php

@@ -0,0 +1,19 @@
+<?php
+
+/*
+ * Copyright (C) 2013-2016 Mailgun
+ *
+ * This software may be modified and distributed under the terms
+ * of the MIT license. See the LICENSE file for details.
+ */
+
+namespace Mailgun\Resource\Api\Suppression\Bounce;
+
+use Mailgun\Resource\Api\Suppressions\BaseResponse;
+
+/**
+ * @author Sean Johnson <sean@mailgun.com>
+ */
+final class DeleteResponse extends BaseResponse
+{
+}

src/Mailgun/Resource/Api/Suppressions/Bounce/IndexResponse.php

@@ -0,0 +1,62 @@
+<?php
+
+/*
+ * Copyright (C) 2013-2016 Mailgun
+ *
+ * This software may be modified and distributed under the terms
+ * of the MIT license. See the LICENSE file for details.
+ */
+
+namespace Mailgun\Resource\Api\Suppressions\Bounce;
+
+use Mailgun\Resource\ApiResponse;
+use Mailgun\Resource\Api\PaginationResponse;
+use Mailgun\Resource\Api\PagingProvider;
+
+/**
+ * @author Sean Johnson <sean@mailgun.com>
+ */
+final class IndexResponse implements ApiResponse, PagingProvider
+{
+    use PaginationResponse;
+
+    /**
+     * @var Bounce[]
+     */
+    private $items;
+
+    /**
+     * @param Bounce[] $items
+     * @param array    $paging
+     */
+    private function __construct(array $items, array $paging)
+    {
+        $this->items = $items;
+        $this->paging = $paging;
+    }
+
+    /**
+     * @param array $data
+     *
+     * @return IndexResponse
+     */
+    public static function create(array $data)
+    {
+        $bounces = [];
+        if (isset($data['items'])) {
+            foreach ($data['items'] as $item) {
+                $bounces[] = Bounce::create($item);
+            }
+        }
+
+        return new self($bounces, $data['paging']);
+    }
+
+    /**
+     * @return Bounce[]
+     */
+    public function getItems()
+    {
+        return $this->items;
+    }
+}

src/Mailgun/Resource/Api/Suppressions/Bounce/ShowResponse.php

@@ -0,0 +1,125 @@
+<?php
+
+/*
+ * Copyright (C) 2013-2016 Mailgun
+ *
+ * This software may be modified and distributed under the terms
+ * of the MIT license. See the LICENSE file for details.
+ */
+
+namespace Mailgun\Resource\Api\Suppressions\Bounce;
+
+use Mailgun\Resource\ApiResponse;
+
+/**
+ * @author Sean Johnson <sean@mailgun.com>
+ */
+final class ShowResponse implements ApiResponse
+{
+    /**
+     * @var string
+     */
+    private $address;
+
+    /**
+     * @var string
+     */
+    private $code;
+
+    /**
+     * @var string
+     */
+    private $error;
+
+    /**
+     * @var \DateTime
+     */
+    private $createdAt;
+
+    /**
+     * @param string $address
+     */
+    private function __construct($address)
+    {
+        $this->address = $address;
+        $this->createdAt = new \DateTime();
+    }
+
+    /**
+     * @param array $data
+     *
+     * @return ShowResponse
+     */
+    public static function create(array $data)
+    {
+        $bounce = new self($data['address']);
+
+        if (isset($data['code'])) {
+            $this->setCode($data['code']);
+        }
+        if (isset($data['error'])) {
+            $this->setError($data['error']);
+        }
+        if (isset($data['created_at'])) {
+            $this->setCreatedAt(new \DateTime($data['created_at']));
+        }
+
+        return $bounce;
+    }
+
+    /**
+     * @return string
+     */
+    public function getAddress()
+    {
+        return $this->address;
+    }
+
+    /**
+     * @return string
+     */
+    public function getCode()
+    {
+        return $this->code;
+    }
+
+    /**
+     * @param string $code
+     */
+    private function setCode($code)
+    {
+        $this->code = $code;
+    }
+
+    /**
+     * @return string
+     */
+    public function getError()
+    {
+        return $this->error;
+    }
+
+    /**
+     * @param string $error
+     */
+    private function setError($error)
+    {
+        $this->error = $error;
+    }
+
+    /**
+     * @return \DateTime
+     */
+    public function getCreatedAt()
+    {
+        return $this->createdAt;
+    }
+
+    /**
+     * @param \DateTime $createdAt
+     */
+    private function setCreatedAt(\DateTime $createdAt)
+    {
+        $this->createdAt = $createdAt;
+    }
+}

src/Mailgun/Resource/Api/Suppressions/Complaint/CreateResponse.php

@@ -0,0 +1,19 @@
+<?php
+
+/*
+ * Copyright (C) 2013-2016 Mailgun
+ *
+ * This software may be modified and distributed under the terms
+ * of the MIT license. See the LICENSE file for details.
+ */
+
+namespace Mailgun\Resource\Api\Suppressions\Complaint;
+
+use Mailgun\Resource\Api\Suppressions\BaseResponse;
+
+/**
+ * @author Sean Johnson <sean@mailgun.com>
+ */
+final class CreateResponse extends BaseResponse
+{
+}

src/Mailgun/Resource/Api/Suppressions/Complaint/DeleteResponse.php

@@ -0,0 +1,19 @@
+<?php
+
+/*
+ * Copyright (C) 2013-2016 Mailgun
+ *
+ * This software may be modified and distributed under the terms
+ * of the MIT license. See the LICENSE file for details.
+ */
+
+namespace Mailgun\Resource\Api\Suppressions\Complaint;
+
+use Mailgun\Resource\Api\Suppressions\BaseResponse;
+
+/**
+ * @author Sean Johnson <sean@mailgun.com>
+ */
+final class DeleteResponse extends BaseResponse
+{
+}

src/Mailgun/Resource/Api/Suppressions/Complaint/IndexResponse.php

@@ -0,0 +1,62 @@
+<?php
+
+/*
+ * Copyright (C) 2013-2016 Mailgun
+ *
+ * This software may be modified and distributed under the terms
+ * of the MIT license. See the LICENSE file for details.
+ */
+
+namespace Mailgun\Resource\Api\Suppressions\Complaint;
+
+use Mailgun\Resource\ApiResponse;
+use Mailgun\Resource\Api\PaginationResponse;
+use Mailgun\Resource\Api\PagingProvider;
+
+/**
+ * @author Sean Johnson <sean@mailgun.com>
+ */
+final class IndexResponse implements ApiResponse, PagingProvider
+{
+    use PaginationResponse;
+
+    /**
+     * @var Complaint[]
+     */
+    private $items;
+
+    /**
+     * @param Complaint[] $items
+     * @param array       $paging
+     */
+    private function __construct(array $items, array $paging)
+    {
+        $this->items = $items;
+        $this->paging = $paging;
+    }
+
+    /**
+     * @param array $data
+     *
+     * @return IndexResponse
+     */
+    public static function create(array $data)
+    {
+        $complaints = [];
+        if (isset($data['items'])) {
+            foreach ($data['items'] as $item) {
+                $complaints[] = Complaint::create($item);
+            }
+        }
+
+        return new self($complaints, $data['paging']);
+    }
+
+    /**
+     * @return Complaint[]
+     */
+    public function getItems()
+    {
+        return $this->items;
+    }
+}

src/Mailgun/Resource/Api/Suppressions/Complaint/ShowResponse.php

@@ -0,0 +1,77 @@
+<?php
+
+/*
+ * Copyright (C) 2013-2016 Mailgun
+ *
+ * This software may be modified and distributed under the terms
+ * of the MIT license. See the LICENSE file for details.
+ */
+
+namespace Mailgun\Resource\Api\Suppressions\Complaint;
+
+use Mailgun\Resource\ApiResponse;
+
+/**
+ * @author Sean Johnson <sean@mailgun.com>
+ */
+final class ShowResponse implements ApiResponse
+{
+    /**
+     * @var string
+     */
+    private $address;
+
+    /**
+     * @var \DateTime
+     */
+    private $createdAt;
+
+    /**
+     * @param string $address
+     */
+    private function __construct($address)
+    {
+        $this->address = $address;
+        $this->createdAt = new \DateTime();
+    }
+
+    /**
+     * @param array $data
+     *
+     * @return ShowResponse
+     */
+    public static function create(array $data)
+    {
+        $bounce = new self($data['address']);
+
+        if (isset($data['created_at'])) {
+            $this->setCreatedAt(new \DateTime($data['created_at']));
+        }
+
+        return $bounce;
+    }
+
+    /**
+     * @return string
+     */
+    public function getAddress()
+    {
+        return $this->address;
+    }
+
+    /**
+     * @return \DateTime
+     */
+    public function getCreatedAt()
+    {
+        return $this->createdAt;
+    }
+
+    /**
+     * @param \DateTime $createdAt
+     */
+    private function setCreatedAt(\DateTime $createdAt)
+    {
+        $this->createdAt = $createdAt;
+    }
+}

src/Mailgun/Resource/Api/Suppressions/Unsubscribe/CreateResponse.php

@@ -0,0 +1,19 @@
+<?php
+
+/*
+ * Copyright (C) 2013-2016 Mailgun
+ *
+ * This software may be modified and distributed under the terms
+ * of the MIT license. See the LICENSE file for details.
+ */
+
+namespace Mailgun\Resource\Api\Suppressions\Unsubscribe;
+
+use Mailgun\Resource\Api\Suppressions\BaseResponse;
+
+/**
+ * @author Sean Johnson <sean@mailgun.com>
+ */
+final class CreateResponse extends BaseResponse
+{
+}

src/Mailgun/Resource/Api/Suppressions/Unsubscribe/DeleteResponse.php

@@ -0,0 +1,19 @@
+<?php
+
+/*
+ * Copyright (C) 2013-2016 Mailgun
+ *
+ * This software may be modified and distributed under the terms
+ * of the MIT license. See the LICENSE file for details.
+ */
+
+namespace Mailgun\Resource\Api\Suppressions\Unsubscribe;
+
+use Mailgun\Resource\Api\Suppressions\BaseResponse;
+
+/**
+ * @author Sean Johnson <sean@mailgun.com>
+ */
+final class DeleteResponse extends BaseResponse
+{
+}

src/Mailgun/Resource/Api/Suppressions/Unsubscribe/IndexResponse.php

@@ -0,0 +1,62 @@
+<?php
+
+/*
+ * Copyright (C) 2013-2016 Mailgun
+ *
+ * This software may be modified and distributed under the terms
+ * of the MIT license. See the LICENSE file for details.
+ */
+
+namespace Mailgun\Resource\Api\Suppressions\Unsubscribe;
+
+use Mailgun\Resource\ApiResponse;
+use Mailgun\Resource\Api\PaginationResponse;
+use Mailgun\Resource\Api\PagingProvider;
+
+/**
+ * @author Sean Johnson <sean@mailgun.com>
+ */
+final class IndexResponse implements ApiResponse, PagingProvider
+{
+    use PaginationResponse;
+
+    /**
+     * @var Unsubscribe[]
+     */
+    private $items;
+
+    /**
+     * @param Unsubscribe[] $items
+     * @param array         $paging
+     */
+    private function __construct(array $items, array $paging)
+    {
+        $this->items = $items;
+        $this->paging = $paging;
+    }
+
+    /**
+     * @param array $data
+     *
+     * @return IndexResponse
+     */
+    public static function create(array $data)
+    {
+        $unsubscribes = [];
+        if (isset($data['items'])) {
+            foreach ($data['items'] as $item) {
+                $unsubscribes[] = Unsubscribes::create($item);
+            }
+        }
+
+        return new self($unsubscribes, $data['paging']);
+    }
+
+    /**
+     * @return Unsubscribe[]
+     */
+    public function getItems()
+    {
+        return $this->items;
+    }
+}

src/Mailgun/Resource/Api/Suppressions/Unsubscribe/ShowResponse.php

@@ -0,0 +1,101 @@
+<?php
+
+/*
+ * Copyright (C) 2013-2016 Mailgun
+ *
+ * This software may be modified and distributed under the terms
+ * of the MIT license. See the LICENSE file for details.
+ */
+
+namespace Mailgun\Resource\Api\Suppressions\Unsubscribe;
+
+use Mailgun\Resource\ApiResponse;
+
+/**
+ * @author Sean Johnson <sean@mailgun.com>
+ */
+final class ShowResponse implements ApiResponse
+{
+    /**
+     * @var string
+     */
+    private $address;
+
+    /**
+     * @var string
+     */
+    private $tag;
+
+    /**
+     * @var \DateTime
+     */
+    private $createdAt;
+
+    /**
+     * @param string $address
+     */
+    private function __construct($address)
+    {
+        $this->address = $address;
+        $this->createdAt = new \DateTime();
+    }
+
+    /**
+     * @param array $data
+     *
+     * @return ShowResponse
+     */
+    public static function create(array $data)
+    {
+        $unsubscribe = new self($data['address']);
+
+        if (isset($data['tag'])) {
+            $this->setTag($data['tag']);
+        }
+        if (isset($data['created_at'])) {
+            $this->setCreatedAt(new \DateTime($data['created_at']));
+        }
+
+        return $unsubscribe;
+    }
+
+    /**
+     * @return string
+     */
+    public function getAddress()
+    {
+        return $this->address;
+    }
+
+    /**
+     * @return string
+     */
+    public function getTag()
+    {
+        return $this->tag;
+    }
+
+    /**
+     * @param string $tag
+     */
+    private function setTag($tag)
+    {
+        $this->tag = $tag;
+    }
+
+    /**
+     * @return \DateTime
+     */
+    public function getCreatedAt()
+    {
+        return $this->createdAt;
+    }
+
+    /**
+     * @param \DateTime $createdAt
+     */
+    private function setCreatedAt(\DateTime $createdAt)
+    {
+        $this->createdAt = $createdAt;
+    }
+}