Membri e inviti

Gestione dei membri. Sono operazioni da proprietario tramite una sessione utente (JWT); i token API della stanza non possono gestire i membri.

Elencare i membri

GET /api/rooms/:roomId/members
Authorization: Bearer <jwt>

[
  { "userId": "auth0|123456", "email": "owner@example.com", "role": "owner",  "addedAt": 1700000000000 },
  { "userId": "auth0|789012", "email": "editor@example.com", "role": "editor", "addedBy": "auth0|123456" }
]

Leggibile da qualsiasi membro della stanza.

Invitare un membro

POST /api/rooms/:roomId/invite      — owner
Content-Type: application/json

{ "email": "newuser@example.com", "role": "editor" }

Ruoli validi: editor, viewer. Se la persona esiste già viene aggiunta subito; altrimenti viene creato un invito in attesa, accettato automaticamente al suo prossimo accesso.

Rimuovere un membro

DELETE /api/rooms/:roomId/members/:userId     — owner

Rimuove il membro ed elimina la stanza dal suo elenco. Il proprietario non può essere rimosso.

Inviti in attesa

GET    /api/rooms/:roomId/pending-invitations
DELETE /api/rooms/:roomId/pending-invitations/:email
GET    /api/users/pending-invitations          # invitations addressed to the current user
POST   /api/rooms/:roomId/accept-invitation

Usali per elencare e revocare gli inviti pendenti di una stanza, e perché una persona invitata veda e accetti gli inviti a lei indirizzati.