Switch team invites to email-only flow via identity API.

Replace local member UUID invites with platform email invites, SSO post-auth
redirect, and provisioner-backed pending access until accept.

Co-authored-by: Cursor <cursoragent@cursor.com>

app/Http/Controllers/Auth/SsoLoginController.php

@@ -4,6 +4,8 @@ namespace App\Http\Controllers\Auth;
 
 use App\Http\Controllers\Controller;
 use App\Models\User;
+use App\Services\Identity\IdentityTeamClient;
+use App\Services\Qms\TeamMemberProvisioner;
 use Illuminate\Http\Client\Response as HttpResponse;
 use Illuminate\Http\RedirectResponse;
 use Illuminate\Http\Request;
@@ -26,12 +28,14 @@ class SsoLoginController extends Controller
      */
     private const MAX_SSO_ATTEMPTS = 3;
 
-    public function connect(Request $request): RedirectResponse|View
+    public function connect(Request $request, IdentityTeamClient $identity): RedirectResponse|View
     {
         $intended = (string) $request->query('redirect', route('qms.dashboard'));
 
         if (Auth::check()) {
-            return $this->safeRedirect($intended, route('qms.dashboard'));
+            $redirect = $this->resolveLanding($identity, $request->user(), $intended);
+
+            return $this->safeRedirect($redirect, route('qms.dashboard'));
         }
 
         if (! $request->boolean('fallback')) {
@@ -39,7 +43,10 @@ class SsoLoginController extends Controller
         }
 
         if ($this->attemptSilentRefresh($request, $intended)) {
-            return $this->safeRedirect($intended, route('qms.dashboard'));
+            app(TeamMemberProvisioner::class)->sync(Auth::user());
+            $redirect = $this->resolveLanding($identity, Auth::user(), $intended);
+
+            return $this->safeRedirect($redirect, route('qms.dashboard'));
         }
 
         $verifier = Str::random(64);
@@ -115,7 +122,9 @@ class SsoLoginController extends Controller
         $request->session()->regenerate();
         $request->session()->forget('sso.attempts');
 
-        return $this->finishCallback($request, $intended, null);
+        app(TeamMemberProvisioner::class)->sync($user);
+
+        return $this->finishCallback($request, $intended, null, app(IdentityTeamClient::class));
     }
 
     public function failed(Request $request): View
@@ -241,8 +250,12 @@ class SsoLoginController extends Controller
         );
     }
 
-    private function finishCallback(Request $request, string $intended, ?string $error = null): RedirectResponse
-    {
+    private function finishCallback(
+        Request $request,
+        string $intended,
+        ?string $error = null,
+        ?IdentityTeamClient $identity = null,
+    ): RedirectResponse {
         if ($error) {
             $attempts = (int) $request->session()->get('sso.attempts', 0) + 1;
 
@@ -262,7 +275,21 @@ class SsoLoginController extends Controller
             ]);
         }
 
-        return $this->safeRedirect($intended, route('qms.dashboard'));
+        $user = Auth::user();
+        $redirect = ($user instanceof User && $identity)
+            ? $this->resolveLanding($identity, $user, $intended)
+            : $intended;
+
+        return $this->safeRedirect($redirect, route('qms.dashboard'));
+    }
+
+    private function resolveLanding(IdentityTeamClient $identity, User $user, string $intended): string
+    {
+        try {
+            return $identity->postAuthRedirect($user->ownerRef(), $intended);
+        } catch (\Throwable) {
+            return $intended;
+        }
     }
 
     private function safeReturnUrl(string $url): string

app/Http/Controllers/Qms/MemberController.php

@@ -6,6 +6,7 @@ use App\Http\Controllers\Controller;
 use App\Http\Controllers\Qms\Concerns\ScopesToAccount;
 use App\Models\Branch;
 use App\Models\Member;
+use App\Services\Identity\IdentityTeamClient;
 use App\Services\Qms\AuditLogger;
 use Illuminate\Http\RedirectResponse;
 use Illuminate\Http\Request;
@@ -51,22 +52,41 @@ class MemberController extends Controller
         ]);
     }
 
-    public function store(Request $request): RedirectResponse
+    public function store(Request $request, IdentityTeamClient $identity): RedirectResponse
     {
         $this->authorizeAbility($request, 'admin.members.manage');
         $organization = $this->organization($request);
         $owner = $this->ownerRef($request);
 
         $validated = $request->validate([
-            'user_ref' => ['required', 'string', 'max:255'],
+            'email' => ['required', 'email', 'max:255'],
             'role' => ['required', 'string', 'in:'.implode(',', array_keys(config('qms.roles')))],
             'branch_id' => ['nullable', 'integer', 'exists:queue_branches,id'],
         ]);
 
+        $email = strtolower(trim($validated['email']));
+
+        if ($email === strtolower((string) $request->user()->email)) {
+            return back()->withErrors(['email' => 'You cannot invite yourself.']);
+        }
+
+        $identity->inviteAppMember(
+            $owner,
+            $email,
+            ['queue'],
+            [
+                'queue' => [
+                    'organization_id' => $organization->id,
+                    'role' => $validated['role'],
+                    'branch_id' => $validated['branch_id'] ?? null,
+                ],
+            ],
+        );
+
         $member = Member::updateOrCreate(
             [
                 'organization_id' => $organization->id,
-                'user_ref' => $validated['user_ref'],
+                'user_ref' => $email,
             ],
             [
                 'owner_ref' => $owner,
@@ -75,9 +95,9 @@ class MemberController extends Controller
             ],
         );
 
-        AuditLogger::record($owner, 'member.created', $organization->id, $owner, Member::class, $member->id);
+        AuditLogger::record($owner, 'member.invited', $organization->id, $owner, Member::class, $member->id);
 
-        return redirect()->route('qms.members.index')->with('success', 'Member saved.');
+        return redirect()->route('qms.members.index')->with('success', 'Invitation sent to '.$email.'.');
     }
 
     public function destroy(Request $request, Member $member): RedirectResponse

app/Services/Identity/IdentityTeamClient.php

@@ -0,0 +1,74 @@
+<?php
+
+namespace App\Services\Identity;
+
+use Illuminate\Http\Client\Response;
+use Illuminate\Support\Facades\Http;
+use RuntimeException;
+
+class IdentityTeamClient
+{
+    /**
+     * @param  list<string>  $apps
+     * @param  array<string, mixed>  $metadata
+     *
+     * @return array<string, mixed>
+     */
+    public function inviteAppMember(
+        string $ownerPublicId,
+        string $email,
+        array $apps,
+        array $metadata = [],
+        string $role = 'member',
+    ): array {
+        $response = $this->request('post', '/identity/team/invite', [
+            'owner' => $ownerPublicId,
+            'email' => strtolower(trim($email)),
+            'apps' => $apps,
+            'role' => $role,
+            'metadata' => $metadata,
+        ]);
+
+        return (array) $response->json('data', []);
+    }
+
+    public function postAuthRedirect(string $userPublicId, string $intendedUrl): string
+    {
+        $response = $this->request('get', '/identity/team/post-auth-redirect', [
+            'user' => $userPublicId,
+            'redirect' => $intendedUrl,
+        ]);
+
+        return (string) $response->json('data.url', $intendedUrl);
+    }
+
+    /** @return list<array<string, mixed>> */
+    public function teamAccess(string $userPublicId): array
+    {
+        $response = $this->request('get', '/identity/team/access', [
+            'user' => $userPublicId,
+        ]);
+
+        return (array) $response->json('data', []);
+    }
+
+    private function request(string $method, string $path, array $query = []): Response
+    {
+        $url = rtrim((string) config('identity.api_url'), '/').$path;
+        $key = config('identity.api_key');
+
+        if ($url === '' || ! is_string($key) || $key === '') {
+            throw new RuntimeException('Identity API is not configured.');
+        }
+
+        $response = Http::withToken($key)
+            ->timeout(10)
+            ->{$method}($url, $query);
+
+        if (! $response->successful()) {
+            throw new RuntimeException($response->json('message') ?: 'Identity API request failed.');
+        }
+
+        return $response;
+    }
+}

app/Services/Qms/TeamMemberProvisioner.php

@@ -0,0 +1,56 @@
+<?php
+
+namespace App\Services\Qms;
+
+use App\Models\Member;
+use App\Models\User;
+use App\Services\Identity\IdentityTeamClient;
+
+class TeamMemberProvisioner
+{
+    public function __construct(
+        protected IdentityTeamClient $identity,
+    ) {}
+
+    public function sync(User $user): void
+    {
+        Member::query()
+            ->where('user_ref', strtolower((string) $user->email))
+            ->update(['user_ref' => $user->ownerRef()]);
+
+        try {
+            $access = $this->identity->teamAccess($user->ownerRef());
+        } catch (\Throwable) {
+            return;
+        }
+
+        foreach ($access as $grant) {
+            if (($grant['self'] ?? false) || ($grant['full_access'] ?? false)) {
+                continue;
+            }
+
+            $apps = (array) ($grant['apps'] ?? []);
+            if (! in_array('queue', $apps, true)) {
+                continue;
+            }
+
+            $meta = (array) data_get($grant, 'metadata.queue', []);
+            $organizationId = (int) ($meta['organization_id'] ?? 0);
+            if ($organizationId <= 0) {
+                continue;
+            }
+
+            Member::updateOrCreate(
+                [
+                    'organization_id' => $organizationId,
+                    'user_ref' => $user->ownerRef(),
+                ],
+                [
+                    'owner_ref' => (string) ($grant['account'] ?? $user->ownerRef()),
+                    'role' => (string) ($meta['role'] ?? 'member'),
+                    'branch_id' => $meta['branch_id'] ?? null,
+                ],
+            );
+        }
+    }
+}

resources/views/qms/admin/members/create.blade.php

@@ -1,16 +1,38 @@
 <x-app-layout title="Add member">
     <div class="mx-auto max-w-lg">
-        <h1 class="text-2xl font-semibold">Add team member</h1>
-        <form method="POST" action="{{ route('qms.members.store') }}" class="mt-6 space-y-4 rounded-2xl border bg-white p-6">
+        <h1 class="text-xl font-semibold text-slate-900">Invite team member</h1>
+
+        <form method="POST" action="{{ route('qms.members.store') }}" class="mt-6 space-y-4 rounded-2xl border border-slate-200 bg-white p-6">
             @csrf
-            <div><label class="block text-sm font-medium">Platform user ref (public_id)</label><input name="user_ref" required class="mt-1 w-full rounded-lg border-slate-300 text-sm font-mono"></div>
-            <div><label class="block text-sm font-medium">Role</label>
-                <select name="role" required class="mt-1 w-full rounded-lg border-slate-300 text-sm">@foreach ($roles as $v => $l)<option value="{{ $v }}">{{ $l }}</option>@endforeach</select>
+
+            <div>
+                <label class="block text-sm font-medium text-slate-700">Email address</label>
+                <input type="email" name="email" value="{{ old('email') }}" required
+                       class="mt-1 w-full rounded-lg border-slate-300 text-sm"
+                       placeholder="colleague@company.com">
+                <p class="mt-1 text-xs text-slate-500">They will receive an email to accept and join your Queue organization.</p>
             </div>
-            <div><label class="block text-sm font-medium">Branch scope (optional)</label>
-                <select name="branch_id" class="mt-1 w-full rounded-lg border-slate-300 text-sm"><option value="">Organization-wide</option>@foreach ($branches as $b)<option value="{{ $b->id }}">{{ $b->name }}</option>@endforeach</select>
+
+            <div>
+                <label class="block text-sm font-medium text-slate-700">Role</label>
+                <select name="role" required class="mt-1 w-full rounded-lg border-slate-300 text-sm">
+                    @foreach ($roles as $v => $l)
+                        <option value="{{ $v }}" @selected(old('role') === $v)>{{ $l }}</option>
+                    @endforeach
+                </select>
             </div>
-            <button type="submit" class="btn-primary w-full">Save member</button>
+
+            <div>
+                <label class="block text-sm font-medium text-slate-700">Branch scope (optional)</label>
+                <select name="branch_id" class="mt-1 w-full rounded-lg border-slate-300 text-sm">
+                    <option value="">Organization-wide</option>
+                    @foreach ($branches as $b)
+                        <option value="{{ $b->id }}" @selected(old('branch_id') == $b->id)>{{ $b->name }}</option>
+                    @endforeach
+                </select>
+            </div>
+
+            <button type="submit" class="btn-primary w-full">Send invitation</button>
         </form>
     </div>
 </x-app-layout>

resources/views/qms/admin/members/index.blade.php

@@ -9,15 +9,20 @@
     <div class="overflow-hidden rounded-2xl border bg-white dark:border-slate-700 dark:bg-slate-900">
         <table class="min-w-full divide-y divide-slate-200">
             <thead class="bg-slate-50"><tr>
-                <th class="px-4 py-3 text-left text-xs font-semibold uppercase text-slate-500">User ref</th>
+                <th class="px-4 py-3 text-left text-xs font-semibold uppercase text-slate-500">Member</th>
                 <th class="px-4 py-3 text-left text-xs font-semibold uppercase text-slate-500">Role</th>
                 <th class="px-4 py-3 text-left text-xs font-semibold uppercase text-slate-500">Branch</th>
                 <th></th>
             </tr></thead>
             <tbody class="divide-y divide-slate-200">
                 @foreach ($members as $member)
+                    @php
+                        $display = str_contains($member->user_ref, '@')
+                            ? $member->user_ref
+                            : (\App\Models\User::where('public_id', $member->user_ref)->value('email') ?? $member->user_ref);
+                    @endphp
                     <tr>
-                        <td class="px-4 py-3 text-sm font-mono text-xs">{{ $member->user_ref }}</td>
+                        <td class="px-4 py-3 text-sm">{{ $display }}</td>
                         <td class="px-4 py-3 text-sm">{{ $roles[$member->role] ?? $member->role }}</td>
                         <td class="px-4 py-3 text-sm">{{ $member->branch?->name ?? 'All' }}</td>
                         <td class="px-4 py-3 text-right">