useTasks

Convex reactive query for tasks with Zustand store synchronization.

useTasks

Source: hooks/commits/useTasks.ts (54 lines)

The useTasks hook fetches all tasks assigned to the current user from the Convex backend using a real-time reactive query, sorts them by recency, and synchronizes the result to the global useTaskStore for cross-screen access.

---

Data Source

Unlike most hooks in the app that read from local SQLite, useTasks queries the Convex backend directly via the reactive useQuery hook:

const tasks = useQuery(
  api.api.commitments.read.byAssignee,
  session?.user?.id ? { assignee_id: session.user.id } : "skip"
);

The “skip” sentinel prevents unauthenticated queries from firing before the session is resolved.

---

Global Store Synchronization

After fetching, the hook pushes data into the global Zustand store for snappier cross-screen access:

useEffect(() => {
  if (tasks) {
    setTasks(tasks); // useTaskStore.setTasks
  }
}, [tasks, setTasks]);

This allows screens like the Calendar and Notifications tabs to read task metadata without their own Convex subscription.

---

Sorting

Tasks are sorted by most recently updated/created in descending order:

const sortedTasks = useMemo(() => {
  if (!tasks) return [];
  return [...tasks].sort((a, b) => {
    const aTime = a.updated_at ?? a.created_at ?? 0;
    const bTime = b.updated_at ?? b.created_at ?? 0;
    return bTime - aTime;
  });
}, [tasks]);

---

Return Value

Field	Type	Purpose
tasks	Task[]	Sorted array of commitments
isLoading	boolean	True while the initial Convex query is in flight
hasTasks	boolean	Convenience flag for empty state rendering
session	Session	Exposed session object for child hooks