Aerendir/aws-ses-monitor-bundle

<?php

declare(strict_types=1);

/*
 * This file is part of the Serendipity HQ Aws Ses Bundle.
 *
 * Copyright (c) Adamo Aerendir Crespi <aerendir@serendipityhq.com>.
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace SerendipityHQ\Bundle\AwsSesMonitorBundle\Util;

use SerendipityHQ\Bundle\AwsSesMonitorBundle\Entity\EmailStatus;
use SerendipityHQ\Bundle\AwsSesMonitorBundle\Service\Monitor;

/**
 * Helps to analyze an EmailStatus to understand if it is bounced, complained or healthy.
 */
final class EmailStatusAnalyzer
{
    private Monitor $monitor;

    public function __construct(Monitor $monitor)
    {
        $this->monitor = $monitor;
    }

    public function canReceiveMessages(EmailStatus $emailStatus, string $identity): bool
    {
        $filter     = $this->monitor->findConfiguredIdentity($identity, 'bounces')['filter'];
        $maxBounces = $filter['max_bounces'];
        $softAsHard = $filter['soft_as_hard'];

        // If this email is bounced
        if ($this->isBounced($emailStatus, $maxBounces, $softAsHard)) {
            // But bounced emails tracking is disabled
            if (false === $this->monitor->bouncesTrackingIsEnabled($identity)) {
                return true;
            }

            // Or anyway the sending to bounced emails is forced
            // if 'false', This email is bounced and cannot receive messages
            return true === $this->monitor->bouncesSendingIsForced($identity);
        }

        // If this email is complained
        if ($this->isComplained($emailStatus)) {
            // But complained emails tracking is disabled
            if (false === $this->monitor->complaintsTrackingIsEnabled($identity)) {
                return true;
            }

            // Or anyway the sending to complained emails is forced
            // If 'false', this email is complained and cannot receive messages
            return true === $this->monitor->complaintsSendingIsForced($identity);
        }

        // This email is not bounced nor complained: can receive messages
        return true;
    }

    public function isBounced(EmailStatus $emailStatus, int $maxBounces, bool $softAsHard = false): bool
    {
        $bouncesCount = $emailStatus->getHardBouncesCount();

        if ($softAsHard) {
            $bouncesCount += $emailStatus->getSoftBouncesCount();
        }

        return $bouncesCount >= $maxBounces;
    }

    public function isComplained(EmailStatus $emailStatus, int $maxComplained = 1): bool
    {
        return $emailStatus->getComplaints()->count() >= $maxComplained;
    }
}