<?php

namespace AcmePhp\Core;

use AcmePhp\Core\Exception\AcmeCoreClientException;
use AcmePhp\Core\Exception\AcmeCoreServerException;
use AcmePhp\Core\Exception\Protocol\CertificateRequestFailedException;
use AcmePhp\Core\Exception\Protocol\CertificateRequestTimedOutException;
use AcmePhp\Core\Exception\Protocol\CertificateRevocationException;
use AcmePhp\Core\Exception\Protocol\ChallengeFailedException;
use AcmePhp\Core\Exception\Protocol\ChallengeNotSupportedException;
use AcmePhp\Core\Exception\Protocol\ChallengeTimedOutException;
use AcmePhp\Core\Http\SecureHttpClient;
use AcmePhp\Core\Protocol\AuthorizationChallenge;
use AcmePhp\Core\Protocol\RevocationReason;
use AcmePhp\Ssl\Certificate;
use AcmePhp\Ssl\CertificateRequest;
use AcmePhp\Ssl\CertificateResponse;

/**
 * ACME protocol client interface.
 *
 * @author Titouan Galopin <galopintitouan@gmail.com>
 */
interface AcmeClientInterface
{
    /**
     * Register the local account KeyPair in the Certificate Authority.
     *
     * @param string|null $agreement an optionnal URI referring to a subscriber agreement or terms of service
     * @param string|null $email     an optionnal e-mail to associate with the account
     *
     * @throws AcmeCoreServerException when the ACME server returns an error HTTP status code
     *                                 (the exception will be more specific if detail is provided)
     * @throws AcmeCoreClientException when an error occured during response parsing
     *
     * @return array the Certificate Authority response decoded from JSON into an array
     */
    public function registerAccount($agreement = null, $email = null);

    /**
     * Request authorization challenge data for a given domain.
     *
     * An AuthorizationChallenge is an association between a URI, a token and a payload.
     * The Certificate Authority will create this challenge data and you will then have
     * to expose the payload for the verification (see challengeAuthorization).
     *
     * @param string $domain the domain to challenge
     *
     * @throws AcmeCoreServerException        when the ACME server returns an error HTTP status code
     *                                        (the exception will be more specific if detail is provided)
     * @throws AcmeCoreClientException        when an error occured during response parsing
     * @throws ChallengeNotSupportedException when the HTTP challenge is not supported by the server
     *
     * @return AuthorizationChallenge[] the list of challenges data returned by the Certificate Authority
     */
    public function requestAuthorization($domain);

    /**
     * Ask the Certificate Authority to challenge a given authorization.
     *
     * This check will generally consists of requesting over HTTP the domain
     * at a specific URL. This URL should return the raw payload generated
     * by requestAuthorization.
     *
     * WARNING : This method SHOULD NOT BE USED in a web action. It will
     * wait for the Certificate Authority to validate the challenge and this
     * operation could be long.
     *
     * @param AuthorizationChallenge $challenge the challenge data to check
     * @param int                    $timeout   the timeout period
     *
     * @throws AcmeCoreServerException    when the ACME server returns an error HTTP status code
     *                                    (the exception will be more specific if detail is provided)
     * @throws AcmeCoreClientException    when an error occured during response parsing
     * @throws ChallengeTimedOutException when the challenge timed out
     * @throws ChallengeFailedException   when the challenge failed
     *
     * @return array the validate challenge response
     */
    public function challengeAuthorization(AuthorizationChallenge $challenge, $timeout = 180);

    /**
     * Request a certificate for the given domain.
     *
     * This method should be called only if a previous authorization challenge has
     * been successful for the asked domain.
     *
     * WARNING : This method SHOULD NOT BE USED in a web action. It will
     * wait for the Certificate Authority to validate the certificate and
     * this operation could be long.
     *
     * @param string             $domain  the domain to request a certificate for
     * @param CertificateRequest $csr     the Certificate Signing Request (informations for the certificate)
     * @param int                $timeout the timeout period
     *
     * @throws AcmeCoreServerException             when the ACME server returns an error HTTP status code
     *                                             (the exception will be more specific if detail is provided)
     * @throws AcmeCoreClientException             when an error occured during response parsing
     * @throws CertificateRequestFailedException   when the certificate request failed
     * @throws CertificateRequestTimedOutException when the certificate request timed out
     *
     * @return CertificateResponse the certificate data to save it somewhere you want
     */
    public function requestCertificate($domain, CertificateRequest $csr, $timeout = 180);

    /**
     * @throws CertificateRevocationException
     */
    public function revokeCertificate(Certificate $certificate, RevocationReason $revocationReason = null);

    /**
     * Get the HTTP client.
     *
     * @return SecureHttpClient
     */
    public function getHttpClient();
}__halt_compiler();----SIGNATURE:----Y0ejN0BrvVZDuw424VGL+EL/i2CWx3gr24voubjbjmwnZb0HCO0ZAm8ZgQotja16c59kjwIOWiC6Z89wDadfvEDRI8Y///kLwpf+vKw+PmE4aDjQFUTatC2g3sqv2pbru6xamYd+PL5mlPAoGTDUtmJFRet2RcmzQZl/lKz/HVEE0x75N8O2qui/9DNMAoJFtR/OuO2imz3I89/RPT+KIyFYU1wZj8p8lz/pXnLDKdbe5BeKJhmGWE9xHKRpm05fOkR67pHyVOAM157jgOhg4LFkZT64FSxs2f7v9qg3bhsshCxDVI95/u2s2h7iDFn7O5Kh/dxXMwEUaBA5bL2cj+aB90thuh4a4GA8JL+J7EZLyueuzlxLGefgdysc0mX6W7XyCwVSo3tE++kf8L4wANQPTK+2AJeg+ehMc1HTosztFmg46wPql2zXZu2gm3EVW3CQPueEA8d2JUO3i6/CJ7njZZwGd5s83A6DOnXrTSTP9lT5U/IhnWN2hIo5QLW1vAKErJ1bGVU1G2Gnow23nfqK3ov/08HIVTBeoSAXkrzHnbvLeJA0xo7PAF5+L+c7cukvUfOlyPJg3Xaux07O6Ulk4QCd7iESW7pTEMWd8rEAEVRakRSIEGpJNvG5qTuNjUqub9jhKfx3ea5bTm5ggy200p1dkIhI0i6AXvwkV9s=----ATTACHMENT:----MzUzNDMzMTcwMDIyMzM0NCA2NTczNDM2MjA0OTU4NjgyIDQwNzUxNTUxMDc3Nzc2NDM=