Add metadata support for emails

src/Endpoints/EmailEndpoint.php

@@ -15,7 +15,7 @@ class EmailEndpoint extends Endpoint
     private ?string $idempotencyKey = null;
 
     /**
-     * Set the custom headeres.
+     * Set the custom headers.
      *
      * @example ["Key" => "Value"]
      *
@@ -169,6 +169,20 @@ public function idempotencyKey(string $key): self
         return $this;
     }
 
+    /**
+     * Set custom metadata.
+     *
+     * @example ["key" => "value"]
+     *
+     * @param  array<string, string>  $metadata  The metadata object.
+     */
+    public function metadata(array $metadata): self
+    {
+        $this->payload['metadata'] = $metadata;
+
+        return $this;
+    }
+
     /**
      * Send the composed email using the current payload.
      *

tests/Endpoints/EmailEndpointTest.php

@@ -233,3 +233,23 @@
         ->subject('Test Subject')
         ->send();
 });
+
+test('it handles metadata', function () {
+    $this->httpClient
+        ->shouldReceive('post')
+        ->once()
+        ->with('/v1/send', [
+            'from' => 'sender@example.com',
+            'to' => ['recipient@example.com'],
+            'subject' => 'Test Subject',
+            'metadata' => ['foo' => 'bar'],
+        ], [])
+        ->andReturn(['message_id' => '123', 'status' => 'pending']);
+
+    $this->endpoint
+        ->from('sender@example.com')
+        ->to('recipient@example.com')
+        ->subject('Test Subject')
+        ->metadata(['foo' => 'bar'])
+        ->send();
+});