use-members.ts · Source

use-members.tsapps/web/src/hooks/use-members.tsraw ← hooks3,817 B← Back to the app
1"use client";
2 
3/**
4 * use-members — workspace member operations (role change, remove, invite).
5 *
6 * Why not the core `workspaceApi`?
7 *   - `workspaceApi.invite` POSTs to `/workspaces/:id/invites`, but the controller
8 *     only exposes `POST /workspaces/:id/members/invites` (the core path 404s —
9 *     flagged to the core agent). There is also no `GET /workspaces/:id/invites`
10 *     endpoint, so the "pending invites" list can't be backed by an API call.
11 *   - The core client has no member role-change or member-remove method.
12 *
13 * The API is the source of truth for the wire: role values are the UPPERCASE
14 * Prisma enum (OWNER / ADMIN / MEMBER / GUEST) with no normalizing serializer,
15 * while the core `WorkspaceRole` type is lowercase. Per the architecture doc
16 * ("record the conflict rather than guessing") this hook speaks UPPERCASE on the
17 * wire (matches the real API + zod `WORKSPACE_ROLES`) and offers `roleLabel` for
18 * display. Role *writes* here are therefore UPPERCASE — note this is the opposite
19 * case from the core type; when the core client is fixed to the real endpoints it
20 * should align to this wire casing (or a serializer should normalize both).
21 */
22import { useMutation, useQueryClient } from "@tanstack/react-query";
23import { apiFetch } from "@/lib/api";
24 
25/** Roles that can be assigned to a member via PATCH …/members/:userId.
26 *  OWNER is never assignable here — ownership changes only via workspace transfer. */
27export const ASSIGNABLE_ROLES = ["ADMIN", "MEMBER", "GUEST"] as const;
28export type AssignableRole = (typeof ASSIGNABLE_ROLES)[number];
29 
30export const ROLE_LABELS: Record<string, string> = {
31  OWNER: "Owner",
32  ADMIN: "Admin",
33  MEMBER: "Member",
34  GUEST: "Guest"
35};
36 
37/** Human label for any role casing (UPPERCASE from the wire, lowercase from core types). */
38export function roleLabel(role: string): string {
39  if (!role) return role;
40  const key = role.toUpperCase();
41  return ROLE_LABELS[key] ?? key.charAt(0).toUpperCase() + key.slice(1).toLowerCase();
42}
43 
44export interface UseMembersArgs {
45  workspaceId: string;
46}
47 
48/** Change a member's role. Owner-only change is not allowed (transfer only). */
49export function useUpdateMemberRole({ workspaceId }: UseMembersArgs) {
50  const qc = useQueryClient();
51  return useMutation({
52    mutationFn: async (input: { userId: string; role: AssignableRole }): Promise<void> => {
53      await apiFetch(`/workspaces/${workspaceId}/members/${input.userId}`, {
54        method: "PATCH",
55        body: { role: input.role }
56      });
57    },
58    onSuccess: () => {
59      qc.invalidateQueries({ queryKey: ["workspaces", workspaceId, "members"] });
60    }
61  });
62}
63 
64/** Remove a member from the workspace. */
65export function useRemoveMember({ workspaceId }: UseMembersArgs) {
66  const qc = useQueryClient();
67  return useMutation({
68    mutationFn: async (userId: string): Promise<void> => {
69      await apiFetch(`/workspaces/${workspaceId}/members/${userId}`, { method: "DELETE" });
70    },
71    onSuccess: () => {
72      qc.invalidateQueries({ queryKey: ["workspaces", workspaceId, "members"] });
73    }
74  });
75}
76 
77/** Invite a member by email. Role must be an assignable role (not OWNER). */
78export function useInviteMember({ workspaceId }: UseMembersArgs) {
79  const qc = useQueryClient();
80  return useMutation({
81    mutationFn: async (input: { email: string; role: AssignableRole }): Promise<void> => {
82      await apiFetch(`/workspaces/${workspaceId}/members/invites`, {
83        method: "POST",
84        body: { email: input.email, role: input.role }
85      });
86    },
87    onSuccess: () => {
88      // The invited user isn't a member until they accept; the members list
89      // won't change, but the invites state (client-side) is reset by the caller.
90      qc.invalidateQueries({ queryKey: ["workspaces", workspaceId] });
91    }
92  });
93}
94