feat(organizations): add functions for managing members TASK-985

[magicznyleszek]

🗒️ Checklist

1. run linter locally
2. update all related docs (API, README, inline, etc.), if any
3. draft PR with a title <type>(<scope>)<!>: <title> TASK-1234
4. tag PR: at least frontend or backend unless it's global
5. fill in the template below and delete template comments
6. review thyself: read the diff and repro the preview as written
7. open PR & confirm that CI passes
8. request reviewers, if needed
9. delete this section before merging

💭 Notes

Not testable per se until further PR is built atop this one and uses it :)

[pauloamorimbr]

We will probably need to add to these file the mutation hooks for the functions and do not export the actual functions above.

/**
 * Mutation hook to patch and organization member.
 * This receives the current members query result to refetch the list after the
 * mutation is successful instead of using query keys duo to pagination parameters.
 */
export const usePatchOrganizationMember = (
  membersQuery: UseQueryResult<PaginatedResponse<OrganizationMember>>
) => {
  const orgQuery = useOrganizationQuery();
  const orgId = orgQuery.data?.id;

  return useMutation({
    mutationFn: ({
      username,
      data,
    }: {
      username: string;
      data: Partial<OrganizationMember>;
    }) => {
      if (!orgId) {
        throw new Error('Organization not found');
      }
      return patchOrganizationMember(orgId, username, data);
    },
    onSuccess: () => {
      // This will refetch the members list
      membersQuery.refetch();
    },
  });
};

/**
 * Mutation hook to remove an organization member.
 * This receives the current members query result to refetch the list after the
 * mutation is successful instead of using query keys duo to pagination parameters.
 */
export const useRemoveOrganizationMember = (
  membersQuery: UseQueryResult<PaginatedResponse<OrganizationMember>>
) => {
  const orgQuery = useOrganizationQuery();
  const orgId = orgQuery.data?.id;

  return useMutation({
    mutationFn: (username: string) => {
      if (!orgId) {
        throw new Error('Organization not found');
      }
      return removeOrganizationMember(orgId, username);
    },
    onSuccess: () => {
      // This will refetch the members list
      membersQuery.refetch();
    },
  });
};

Usage would be something like:

const membersQuery = useOrganizationMembersQuery()
const membersPatch = usePatchOrganizationMember(membersQuery)

const onPatch = (username: string, data:Partial<OrganizationMember>) => {
    membersPatch.mutateAsync({username, data})
}