Membres et invitations

Gestion des membres. Ce sont des opérations de propriétaire via une session utilisateur (JWT) ; les jetons d’API de salle ne peuvent pas gérer les membres.

Lister les membres

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" }
]

Lisible par tout membre de la salle.

Inviter un membre

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

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

Rôles valides : editor, viewer. Si l’utilisateur existe déjà, il est ajouté immédiatement ; sinon une invitation en attente est créée et acceptée automatiquement à sa prochaine connexion.

Retirer un membre

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

Retire le membre et enlève la salle de sa liste. Le propriétaire ne peut pas être retiré.

Invitations en attente

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

Utilisez-les pour lister et annuler les invitations en cours d’une salle, et pour qu’une personne invitée voie et accepte les invitations qui lui sont adressées.