Families API

interface Family {
  _id: Id<"families">;
  name: string;
  ownerId: string; // User ID of family owner
  createdAt: string;
}

interface FamilyMember {
  _id: Id<"familyMembers">;
  familyId: Id<"families">;
  userId: string;
  role: "owner" | "admin" | "caregiver";
  joinedAt: string;
}

interface FamilyInvitation {
  _id: Id<"familyInvitations">;
  familyId: Id<"families">;
  email: string;
  role: string;
  invitedBy: string;
  status: "pending" | "accepted" | "declined" | "expired";
  createdAt: string;
  expiresAt: string;
}

import { useMutation } from "convex/react";
import { api } from "./convex/_generated/api";

const createFamily = useMutation(api.families.createFamily);

const familyId = await createFamily({
  name: "Smith Family"
});

const families = useQuery(api.families.listMyFamilies);

// Response:
[
  {
    _id: "...",
    name: "Smith Family",
    ownerId: "user123",
    createdAt: "2024-03-05T10:00:00Z",
    role: "owner" // Current user's role
  }
]

const family = useQuery(api.families.getFamily, {
  familyId
});

const members = useQuery(api.families.listFamilyMembers, {
  familyId
});

// Response:
[
  {
    _id: "...",
    familyId: "...",
    userId: "user123",
    role: "owner",
    joinedAt: "2024-03-05T10:00:00Z",
    userName: "John Smith",
    userEmail: "john@example.com"
  }
]

const inviteCaregiver = useMutation(api.families.inviteCaregiver);

await inviteCaregiver({
  familyId,
  email: "caregiver@example.com",
  role: "caregiver" // optional, defaults to "caregiver"
});

const invitations = useQuery(api.families.listInvitations, {
  familyId
});

[
  {
    _id: "...",
    familyId: "...",
    email: "caregiver@example.com",
    role: "caregiver",
    status: "pending",
    invitedBy: "user123",
    createdAt: "2024-03-05T10:00:00Z",
    expiresAt: "2024-03-12T10:00:00Z"
  }
]

const acceptInvitation = useMutation(api.families.acceptInvitation);

await acceptInvitation({
  invitationId
});

const declineInvitation = useMutation(api.families.declineInvitation);

await declineInvitation({
  invitationId
});

const removeMember = useMutation(api.families.removeMember);

await removeMember({
  familyId,
  userId: "userToRemove"
});