feat: Add support for email schedule (#57)

Author: jayanratna

src/Service/Email.php

@@ -43,4 +43,32 @@ public function send(array $parameters): \Resend\Email
     {
         return $this->create($parameters);
     }
+
+    /**
+     * Update a scheduled email with the given ID.
+     *
+     * @see https://resend.com/docs/api-reference/emails/update-email
+     */
+    public function update(string $id, array $parameters): \Resend\Email
+    {
+        $payload = Payload::update('emails', $id, $parameters);
+
+        $result = $this->transporter->request($payload);
+
+        return $this->createResource('emails', $result);
+    }
+
+    /**
+     * Cancel a scheduled email with the given ID.
+     *
+     * @see https://resend.com/docs/api-reference/emails/cancel-email
+     */
+    public function cancel(string $id): \Resend\Email
+    {
+        $payload = Payload::cancel('emails', $id);
+
+        $result = $this->transporter->request($payload);
+
+        return $this->createResource('emails', $result);
+    }
 }

src/ValueObjects/ResourceUri.php

@@ -57,12 +57,22 @@ public static function delete(string $resource, string $id): self
 
     /**
      * Create a new Resource URI value object that verifies the given resource.
+     *
+     * @deprecated Use withAction instead
      */
     public static function verify(string $resource, string $id): self
     {
         return new self("{$resource}/{$id}/verify");
     }
 
+    /**
+     * Create a new Resource URI value object with the given action.
+     */
+    public static function withAction(string $resource, string $id, string $action): self
+    {
+        return new self("{$resource}/{$id}/{$action}");
+    }
+
     /**
      * Returns the string representation of the object.
      */

src/ValueObjects/Transporter/Payload.php

@@ -90,7 +90,19 @@ public static function verify(string $resource, string $id): self
     {
         $contentType = ContentType::JSON;
         $method = Method::POST;
-        $uri = ResourceUri::verify($resource, $id);
+        $uri = ResourceUri::withAction($resource, $id, 'verify');
+
+        return new self($contentType, $method, $uri);
+    }
+
+    /**
+     * Create a new Transporter Payload instance.
+     */
+    public static function cancel(string $resource, string $id): self
+    {
+        $contentType = ContentType::JSON;
+        $method = Method::POST;
+        $uri = ResourceUri::withAction($resource, $id, 'cancel');
 
         return new self($contentType, $method, $uri);
     }

tests/Service/Email.php

@@ -10,3 +10,28 @@
     expect($result)->toBeInstanceOf(Email::class)
         ->id->toBe('49a3999c-0ce1-4ea6-ab68-afcd6dc2e794');
 });
+
+it('can update a scheduled email', function () {
+    $client = mockClient('PATCH', 'emails/49a3999c-0ce1-4ea6-ab68-afcd6dc2e794', [
+        'scheduled_at' => '2024-08-05T11:52:01.858Z',
+    ], ['object' => 'email', 'id' => '49a3999c-0ce1-4ea6-ab68-afcd6dc2e794']);
+
+    $result = $client->emails->update('49a3999c-0ce1-4ea6-ab68-afcd6dc2e794', [
+        'scheduled_at' => '2024-08-05T11:52:01.858Z',
+    ]);
+
+    expect($result)->toBeInstanceOf(Email::class)
+        ->id->toBe('49a3999c-0ce1-4ea6-ab68-afcd6dc2e794');
+});
+
+it('can cancel a scheduled email', function () {
+    $client = mockClient('POST', 'emails/49a3999c-0ce1-4ea6-ab68-afcd6dc2e794/cancel', [], [
+        'object' => 'email',
+        'id' => '49a3999c-0ce1-4ea6-ab68-afcd6dc2e794',
+    ]);
+
+    $result = $client->emails->cancel('49a3999c-0ce1-4ea6-ab68-afcd6dc2e794');
+
+    expect($result)->toBeInstanceOf(Email::class)
+        ->id->toBe('49a3999c-0ce1-4ea6-ab68-afcd6dc2e794');
+});