Skip to content

⭐️⭐️⭐️ Open-source, self-hosted alternative to Linear and Plane. Project management and issue tracking where teams and AI agents work side by side to plan and ship products.

1.5 KB
Raw Blame
import { useMutation, useQueryClient, type QueryKey } from '@tanstack/react-query';

// Reorder mutation for a project's ordered lists (views, dashboards, actions).
// Optimistically reorders the cached list so the drag lands immediately, rolls
// back on error, and refetches on settle to reconcile with the server's
// renumbered positions. Items the order leaves out follow it in their cached order.
// Pass a null key to disable the cache work when there is no project.
export function useOptimisticReorder<T extends { id: number }>(
  queryKey: QueryKey | null,
  reorder: (orderedIds: number[]) => Promise<unknown>,
) {
  const qc = useQueryClient();
  return useMutation({
    mutationFn: (orderedIds: number[]) => reorder(orderedIds),
    onMutate: async (orderedIds) => {
      if (!queryKey) return;
      await qc.cancelQueries({ queryKey });
      const previous = qc.getQueryData<T[]>(queryKey);
      if (previous) {
        const byId = new Map(previous.map((item) => [item.id, item]));
        const next = orderedIds.map((id) => byId.get(id)).filter((item): item is T => !!item);
        const moved = new Set(orderedIds);
        qc.setQueryData<T[]>(queryKey, [
          ...next,
          ...previous.filter((item) => !moved.has(item.id)),
        ]);
      }
      return { previous };
    },
    onError: (_err, _orderedIds, ctx) => {
      if (queryKey && ctx?.previous) qc.setQueryData(queryKey, ctx.previous);
    },
    onSettled: () => {
      if (queryKey) void qc.invalidateQueries({ queryKey });
    },
  });
}