Add virtual event sessions with Meet sync and platform-billed messaging.

Events can define hybrid/virtual sessions synced to Meet rooms; SMS and email use wallet-billed platform APIs instead of Termii and Laravel mail. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-01 22:08:09 +00:00
parent 5a8a462102
commit 06fedcfc55
18 changed files with 735 additions and 30 deletions
@@ -0,0 +1,122 @@
+<?php
+
+namespace App\Services\Meet;
+
+use Illuminate\Http\Client\ConnectionException;
+use Illuminate\Http\Client\PendingRequest;
+use Illuminate\Support\Facades\Http;
+
+/**
+ * Client for the Ladill Meet service API — virtual sessions linked to Events.
+ */
+class MeetClient
+{
+    public function __construct(private readonly string $ownerRef) {}
+
+    public static function for(string $ownerRef): self
+    {
+        return new self($ownerRef);
+    }
+
+    /**
+     * @return array<string, mixed>|null
+     */
+    public function findBySource(string $app, string $entityId): ?array
+    {
+        try {
+            $response = $this->client()->get('rooms/by-source', [
+                'source_app' => $app,
+                'entity_id' => $entityId,
+                'owner_ref' => $this->ownerRef,
+            ]);
+        } catch (ConnectionException) {
+            return null;
+        }
+
+        if ($response->status() === 404) {
+            return null;
+        }
+
+        if ($response->failed()) {
+            return null;
+        }
+
+        return (array) $response->json();
+    }
+
+    /**
+     * @param  array<string, mixed>  $data
+     * @return array<string, mixed>
+     */
+    public function upsertRoom(array $data): array
+    {
+        return $this->post('rooms', array_merge($data, [
+            'owner_ref' => $this->ownerRef,
+            'host_user_ref' => $data['host_user_ref'] ?? $this->ownerRef,
+        ]));
+    }
+
+    /**
+     * @param  array<string, mixed>  $data
+     * @return array<string, mixed>
+     */
+    public function updateRoom(string $roomUuid, array $data): array
+    {
+        return $this->patch("rooms/{$roomUuid}", array_merge($data, [
+            'owner_ref' => $this->ownerRef,
+            'host_user_ref' => $data['host_user_ref'] ?? $this->ownerRef,
+        ]));
+    }
+
+    public function cancelRoom(string $roomUuid, ?string $hostUserRef = null): array
+    {
+        return $this->post("rooms/{$roomUuid}/cancel", [
+            'owner_ref' => $this->ownerRef,
+            'host_user_ref' => $hostUserRef ?? $this->ownerRef,
+        ]);
+    }
+
+    private function client(): PendingRequest
+    {
+        return Http::baseUrl((string) config('meet.url'))
+            ->withToken((string) config('meet.key'))
+            ->acceptJson()
+            ->asJson()
+            ->connectTimeout(10)
+            ->timeout(20);
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function post(string $path, array $data): array
+    {
+        return $this->request('post', $path, $data);
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function patch(string $path, array $data): array
+    {
+        return $this->request('patch', $path, $data);
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function request(string $method, string $path, array $data): array
+    {
+        try {
+            $response = $this->client()->{$method}($path, $data);
+        } catch (ConnectionException) {
+            throw new \RuntimeException('Could not reach the Meet service.');
+        }
+
+        if ($response->failed()) {
+            throw new \RuntimeException('Meet service error: '.($response->json('message') ?? $response->body()));
+        }
+
+        return (array) $response->json();
+    }
+}