feat: Add Vonage Messages Adapter (#8139)

[deepshekhardas]

This PR adds support for Vonage Messages API adapter.

Changes:

• Implements Vonage Messages API integration
• Supports multiple message types (SMS, WhatsApp, etc.)
• Follows existing adapter patterns

---

Summary by cubic

Add a Vonage Messages adapter with SMS, WhatsApp, Viber, and MMS support. Uses a shared trait with JWT auth and follows the existing adapter pattern.

• New Features

  • Added abstract channel adapters: WhatsApp, Viber, MMS.
  • Added channel implementations: SMS\VonageMessages, WhatsApp\Vonage, Viber\Vonage, MMS\Vonage.
  • Introduced VonageTrait to build payloads, sign JWTs (RS256), and POST to https://api.nexmo.com/v1/messages.
  • Sends one recipient per request and returns a normalized response (delivered on 2xx with message_uuid, otherwise includes error).

• Migration

  • Construct adapters with Vonage Application ID and Private Key; optional from is supported.
  • No breaking changes to existing adapters.

^{Written for commit ba22934. Summary will update on new commits.}

[cubic-dev-ai]

2 issues found across 9 files

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="src/Utopia/Messaging/Adapter/VonageTrait.php">

<violation number="1" location="src/Utopia/Messaging/Adapter/VonageTrait.php:30">
P2: Guard against empty recipient lists before reading `$message->getTo()[0]`; otherwise this path triggers undefined index warnings and builds invalid requests.</violation>
</file>

<file name="src/Utopia/Messaging/Adapter/SMS/VonageMessages.php">

<violation number="1" location="src/Utopia/Messaging/Adapter/SMS/VonageMessages.php:12">
P1: `VonageTrait` is referenced from the wrong namespace. This class needs to import or fully qualify `Utopia\Messaging\Adapter\VonageTrait`, otherwise it will fail to load.</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.}

[cubic-dev-ai]

P1: VonageTrait is referenced from the wrong namespace. This class needs to import or fully qualify Utopia\Messaging\Adapter\VonageTrait, otherwise it will fail to load.

Prompt for AI agents

Check if this issue is valid — if so, understand the root cause and fix it. At src/Utopia/Messaging/Adapter/SMS/VonageMessages.php, line 12:

<comment>`VonageTrait` is referenced from the wrong namespace. This class needs to import or fully qualify `Utopia\Messaging\Adapter\VonageTrait`, otherwise it will fail to load.</comment>

<file context>
@@ -0,0 +1,34 @@
+
+class VonageMessages extends SMSAdapter
+{
+    use VonageTrait;
+
+    protected const NAME = 'VonageMessages';
</file context>

Suggested change

	use VonageTrait;
	use \Utopia\Messaging\Adapter\VonageTrait;

[cubic-dev-ai]

P2: Guard against empty recipient lists before reading $message->getTo()[0]; otherwise this path triggers undefined index warnings and builds invalid requests.

Prompt for AI agents

Check if this issue is valid — if so, understand the root cause and fix it. At src/Utopia/Messaging/Adapter/VonageTrait.php, line 30:

<comment>Guard against empty recipient lists before reading `$message->getTo()[0]`; otherwise this path triggers undefined index warnings and builds invalid requests.</comment>

<file context>
@@ -0,0 +1,72 @@
+    {
+        $payload = [
+            'from' => $this->from ?? $message->getFrom(),
+            'to' => \ltrim($message->getTo()[0], '+'),
+            'message_type' => 'text',
+            'text' => $message->getContent(),
</file context>