composer require shoutboxnet/shoutbox

use Shoutbox\Client;
use Shoutbox\EmailOptions;

$apiKey = getenv('SHOUTBOX_API_KEY') ?: 'your-api-key-here';
$client = new Client($apiKey);

try {
    $options = new EmailOptions();
    $options->from = '[email protected]';
    $options->to = '[email protected]';
    $options->subject = 'Test Email';
    $options->html = '<h1>Hello!</h1><p>This is a test email.</p>';
    $options->name = 'Sender Name';
    $options->replyTo = '[email protected]';

    $client->sendEmail($options);
    echo "Email sent successfully!\n";
} catch (Exception $e) {
    echo "Error: " . $e->getMessage() . "\n";
}

$options = new EmailOptions();
$options->from = '[email protected]';
$options->to = [
    '[email protected]',
    '[email protected]'
];
$options->cc = [
    '[email protected]',
    '[email protected]'
];
$options->subject = 'Group Email';
$options->html = '<h1>Hello Everyone!</h1>';

$client->sendEmail($options);

use Shoutbox\Attachment;

$attachment = new Attachment();
$attachment->filepath = './document.pdf';
$attachment->filename = 'report.pdf'; // Optional
$attachment->contentType = 'application/pdf'; // Optional

$options = new EmailOptions();
$options->from = '[email protected]';
$options->to = '[email protected]';
$options->subject = 'Document Attached';
$options->html = '<h1>Please find the document attached</h1>';
$options->attachments = [$attachment];

$client->sendEmail($options);

$options = new EmailOptions();
$options->from = '[email protected]';
$options->to = '[email protected]';
$options->subject = 'Test Email';
$options->html = '<h1>Hello!</h1>';
$options->headers = [
    'X-Custom-Header' => 'Custom Value',
    'X-Priority' => '1'
];

$client->sendEmail($options);

$options = new EmailOptions();
$options->from = '[email protected]';
$options->to = '[email protected]';
$options->subject = 'Tagged Email';
$options->html = '<h1>Hello!</h1>';
$options->tags = ['welcome', 'onboarding'];

$client->sendEmail($options);

class EmailOptions {
    public string $from;              // Required: Sender email
    public string|array $to;          // Required: Recipient email(s)
    public string $subject;           // Required: Email subject
    public string $html;              // Optional: HTML content
    public string $text;              // Optional: Plain text content
    public string $name;              // Optional: Sender name
    public string $replyTo;           // Optional: Reply-to address
    public string|array $cc;          // Optional: CC recipient(s)
    public string|array $bcc;         // Optional: BCC recipient(s)
    public array $attachments;        // Optional: File attachments
    public array $headers;            // Optional: Custom headers
    public array $tags;               // Optional: Email tags
}

class Attachment {
    public string $filepath;          // Required: Path to file
    public string $filename;          // Optional: Custom filename
    public string $contentType;       // Optional: MIME type
    public string $content;           // Optional: Base64 content
}

try {
    $client->sendEmail($options);
} catch (\Shoutbox\Exceptions\ApiException $e) {
    // Handle API-specific errors
    echo "API Error: " . $e->getMessage() . "\n";
    echo "Status Code: " . $e->getCode() . "\n";
} catch (\Shoutbox\Exceptions\ValidationException $e) {
    // Handle validation errors
    echo "Validation Error: " . $e->getMessage() . "\n";
} catch (\Exception $e) {
    // Handle other errors
    echo "General Error: " . $e->getMessage() . "\n";
}

try {
    $options = new EmailOptions();
    // Missing required fields will throw ValidationException
    $client->sendEmail($options);
} catch (\Shoutbox\Exceptions\ValidationException $e) {
    echo "Validation failed: " . $e->getMessage() . "\n";
    // Access validation errors
    foreach ($e->getErrors() as $field => $error) {
        echo "$field: $error\n";
    }
}

// Load from environment
$apiKey = getenv('SHOUTBOX_API_KEY');
if (!$apiKey) {
    throw new RuntimeException('SHOUTBOX_API_KEY not set');
}

$client = new Client($apiKey);

class EmailSender {
    private $client;
    private $lastSent = 0;
    private $rateLimit = 1; // seconds between sends

    public function __construct(Client $client) {
        $this->client = $client;
    }

    public function sendWithRateLimit(EmailOptions $options) {
        $now = time();
        $timeSinceLastSend = $now - $this->lastSent;
        
        if ($timeSinceLastSend < $this->rateLimit) {
            sleep($this->rateLimit - $timeSinceLastSend);
        }

        $this->client->sendEmail($options);
        $this->lastSent = time();
    }
}

class BulkEmailSender {
    private $client;
    private $batchSize = 50;
    private $delayBetweenBatches = 1; // seconds

    public function __construct(Client $client) {
        $this->client = $client;
    }

    public function sendBulk(array $recipients, EmailOptions $template) {
        $batches = array_chunk($recipients, $this->batchSize);

        foreach ($batches as $batch) {
            foreach ($batch as $recipient) {
                $options = clone $template;
                $options->to = $recipient;
                
                try {
                    $this->client->sendEmail($options);
                } catch (Exception $e) {
                    // Log error and continue
                    error_log("Failed to send to {$recipient}: {$e->getMessage()}");
                }
            }

            // Delay between batches
            sleep($this->delayBetweenBatches);
        }
    }
}

use PHPUnit\Framework\TestCase;
use Shoutbox\Client;
use Shoutbox\EmailOptions;

class EmailTest extends TestCase
{
    private $client;

    protected function setUp(): void
    {
        $this->client = new Client('test-api-key');
    }

    public function testSendEmail()
    {
        $options = new EmailOptions();
        $options->from = '[email protected]';
        $options->to = '[email protected]';
        $options->subject = 'Test Email';
        $options->html = '<h1>Test</h1>';

        $result = $this->client->sendEmail($options);
        $this->assertTrue($result);
    }
}