feat: Add batch emails API support (#43)

Author: jayanratna

composer.json

@@ -16,8 +16,8 @@
     },
     "require-dev": {
         "friendsofphp/php-cs-fixer": "^3.13",
-        "pestphp/pest": "^2.0",
-        "pestphp/pest-plugin-mock": "^2.0"
+        "mockery/mockery": "^1.6",
+        "pestphp/pest": "^2.0"
     },
     "autoload": {
         "psr-4": {

phpunit.xml

@@ -3,6 +3,7 @@
          xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.0/phpunit.xsd"
          colors="true"
          cacheDirectory=".phpunit.cache"
+         beStrictAboutOutputDuringTests="true"
 >
     <testsuites>
         <testsuite name="default">

src/Client.php

@@ -10,6 +10,7 @@
  * Client used to send requests to the Resend API.
  *
  * @property \Resend\Service\ApiKey $apiKeys
+ * @property \Resend\Service\Batch $batch
  * @property \Resend\Service\Domain $domains
  * @property \Resend\Service\Email $emails
  */

src/Service/Batch.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace Resend\Service;
+
+use Resend\ValueObjects\Transporter\Payload;
+
+class Batch extends Service
+{
+    /**
+     * Send a batch of emails with the given parameters.
+     *
+     * @return \Resend\Collection<\Resend\Email>
+     *
+     * @see https://resend.com/docs/api-reference/emails/send-batch-emails#body-parameters
+     */
+    public function create(array $parameters): \Resend\Collection
+    {
+        $payload = Payload::create('emails/batch', $parameters);
+
+        $result = $this->transporter->request($payload);
+
+        return $this->createResource('emails', $result);
+    }
+
+    /**
+     * Send a batch of emails with the given parameters.
+     *
+     * @return \Resend\Collection<\Resend\Email>
+     *
+     * @see https://resend.com/docs/api-reference/emails/send-batch-emails#body-parameters
+     */
+    public function send(array $parameters): \Resend\Collection
+    {
+        return $this->create($parameters);
+    }
+}

src/Service/ServiceFactory.php

@@ -13,6 +13,7 @@ class ServiceFactory
      */
     private static array $classMap = [
         'apiKeys' => ApiKey::class,
+        'batch' => Batch::class,
         'domains' => Domain::class,
         'emails' => Email::class,
     ];

tests/Fixtures/Email.php

@@ -9,3 +9,17 @@ function email(): array
         'created_at' => '2022-07-25T00:28:32.493138+00:00',
     ];
 }
+
+function batch(): array
+{
+    return [
+        'data' => [
+            [
+                'id' => '49a3999c-0ce1-4ea6-ab68-afcd6dc2e794',
+            ],
+            [
+                'id' => '49a3999c-0ce1-4ea6-ab68-afcd6dc2e794',
+            ],
+        ],
+    ];
+}

tests/Pest.php

@@ -15,12 +15,16 @@ function mockClient(string $method, string $resource, array $parameters, array|s
     $transporter
         ->shouldReceive($methodName)
         ->once()
-        ->withArgs(function (Payload $payload) use ($method, $resource) {
+        ->withArgs(function (Payload $payload) use ($method, $resource, $parameters) {
             $baseUri = BaseUri::from('api.resend.com');
             $headers = Headers::withAuthorization(ApiKey::from('foo'));
 
             $request = $payload->toRequest($baseUri, $headers);
 
+            if ($method === 'POST' && (string) $request->getBody() !== json_encode($parameters)) {
+                return false;
+            }
+
             return $request->getMethod() === $method
                 && $request->getHeader('User-Agent')[0] === 'resend-php/' . Resend::VERSION
                 && $request->getUri()->getPath() === "/{$resource}";

tests/Service/Batch.php

@@ -0,0 +1,27 @@
+<?php
+
+use Resend\Collection;
+
+it('can send a  batch of emails', function () {
+    $payload = [
+        [
+            'to' => '[email protected]',
+            'from' => '[email protected]',
+            'subject' => 'Acme',
+            'text' => 'it works!',
+        ],
+        [
+            'to' => '[email protected]',
+            'from' => '[email protected]',
+            'subject' => 'Acme',
+            'text' => 'it works!',
+        ],
+    ];
+
+    $client = mockClient('POST', 'emails/batch', $payload, batch());
+
+    $result = $client->batch->send($payload);
+
+    expect($result)->toBeInstanceOf(Collection::class)
+        ->data->toBeArray();
+});