<?php

declare(strict_types=1);

/*
 * Copyright (C) 2013 Mailgun
 *
 * This software may be modified and distributed under the terms
 * of the MIT license. See the LICENSE file for details.
 */

namespace Mailgun\Api\Suppression;

use Mailgun\Api\HttpApi;
use Mailgun\Api\Pagination;
use Mailgun\Assert;
use Mailgun\Message\Exceptions\RuntimeException;
use Mailgun\Model\Suppression\Bounce\CreateResponse;
use Mailgun\Model\Suppression\Bounce\DeleteResponse;
use Mailgun\Model\Suppression\Bounce\IndexResponse;
use Mailgun\Model\Suppression\Bounce\ShowResponse;
use Psr\Http\Client\ClientExceptionInterface;
use Throwable;

/**
 * @see https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/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
     * @param  array                    $requestHeaders
     * @return IndexResponse|null
     * @throws ClientExceptionInterface
     */
    public function index(string $domain, int $limit = 100, array $requestHeaders = []): ?IndexResponse
    {
        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, $requestHeaders);

        return $this->hydrateResponse($response, IndexResponse::class);
    }

    /**
     * @param  string                   $domain         Domain to show bounce from
     * @param  string                   $address        Bounce address to show
     * @param  array                    $requestHeaders
     * @return ShowResponse|null
     * @throws ClientExceptionInterface
     */
    public function show(string $domain, string $address, array $requestHeaders = []): ?ShowResponse
    {
        Assert::stringNotEmpty($domain);
        Assert::stringNotEmpty($address);

        $response = $this->httpGet(sprintf('/v3/%s/bounces/%s', $domain, $address), [], $requestHeaders);

        return $this->hydrateResponse($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
     * @param  array                    $requestHeaders
     * @return CreateResponse|null
     * @throws ClientExceptionInterface
     */
    public function create(string $domain, string $address, array $params = [], array $requestHeaders = []): ?CreateResponse
    {
        Assert::stringNotEmpty($domain);
        Assert::stringNotEmpty($address);

        $params['address'] = $address;

        $response = $this->httpPost(sprintf('/v3/%s/bounces', $domain), $params, $requestHeaders);

        return $this->hydrateResponse($response, CreateResponse::class);
    }

    /**
     * @param  string                   $domain         Domain to delete a bounce for
     * @param  string                   $address        Bounce address to delete
     * @param  array                    $requestHeaders
     * @return DeleteResponse|null
     * @throws ClientExceptionInterface
     */
    public function delete(string $domain, string $address, array $requestHeaders = []): ?DeleteResponse
    {
        Assert::stringNotEmpty($domain);
        Assert::stringNotEmpty($address);

        $response = $this->httpDelete(sprintf('/v3/%s/bounces/%s', $domain, $address), [], $requestHeaders);

        return $this->hydrateResponse($response, DeleteResponse::class);
    }

    /**
     * @param  string                   $domain         Domain to delete all bounces for
     * @param  array                    $requestHeaders
     * @return DeleteResponse|null
     * @throws ClientExceptionInterface
     */
    public function deleteAll(string $domain, array $requestHeaders = []): ?DeleteResponse
    {
        Assert::stringNotEmpty($domain);

        $response = $this->httpDelete(sprintf('/v3/%s/bounces', $domain), [], $requestHeaders);

        return $this->hydrateResponse($response, DeleteResponse::class);
    }

    /**
     * @param string $domainId
     * @param array $bounces
     * @param array $requestHeaders
     * @return mixed
     */
    public function importBouncesList(string $domainId, array $bounces, array $requestHeaders = [])
    {
        try {
            $response = $this->httpPostRaw(
                sprintf('/v3/%s/bounces/import', $domainId),
                $bounces,
                $requestHeaders
            );
        } catch (Throwable $throwable) {
            throw new RuntimeException($throwable->getMessage(), 0, $throwable);
        }

        return $this->hydrateResponse($response, CreateResponse::class);
    }
}
