feat: allow callback url to be supplied for emergency notifications

src/PushoverMessage.php

@@ -85,6 +85,13 @@ class PushoverMessage
      * @var string|null
      */
     public string|null $image = null;
+    /**
+     * The (optional) publicly-accessible url that Pushover will use to notify your system when a user
+     * acknowledges an Emergency notification.
+     *
+     * @var string|null
+     */
+    public string|null $callback = null;
 
     /**
      * Message formats.
@@ -324,6 +331,20 @@ public function emergencyPriority(int $retryTimeout, int $expireAfter): static
         return $this->priority(self::EMERGENCY_PRIORITY, $retryTimeout, $expireAfter);
     }
 
+    /**
+     * Set the callback url used by pushover to let your system
+     * know when a emergency notification has been acknowledged.
+     *
+     * @param  string  $url
+     * @return $this
+     */
+    public function callback(string $url): static
+    {
+        $this->callback = $url;
+
+        return $this;
+    }
+
     /**
      * Array representation of Pushover Message.
      *
@@ -344,6 +365,7 @@ public function toArray(): array
             'expire' => $this->expire,
             'html' => $this->format === static::FORMAT_HTML,
             'monospace' => $this->format === static::FORMAT_MONOSPACE,
+            'callback' => $this->callback,
         ];
     }
 

tests/PushoverMessageTest.php

@@ -190,4 +190,13 @@ public function it_can_set_the_priority_to_emergency(): void
 
         $this->assertEquals(2, $this->message->priority);
     }
+
+    public function it_can_set_the_callback_url(): void
+    {
+        $callbackUrl = 'https://www.example.com/callback';
+
+        $this->message->callback($callbackUrl);
+
+        $this->assertEquals($callbackUrl, $this->message->callback);
+    }
 }