react-use/src/useUpsert.ts

import useList, { ListActions } from './useList';
import { InitialHookState } from './util/resolveHookState';

export interface UpsertListActions<T> extends Omit<ListActions<T>, 'upsert'> {
  upsert: (newItem: T) => void;
}

/**
 * @deprecated Use `useList` hook's upsert action instead
 */
export default function useUpsert<T>(
  predicate: (a: T, b: T) => boolean,
  initialList: InitialHookState<T[]> = []
): [T[], UpsertListActions<T>] {
  const [list, listActions] = useList(initialList);

  return [
    list,
    {
      ...listActions,
      upsert: (newItem: T) => {
        listActions.upsert(predicate, newItem);
      },
    } as UpsertListActions<T>,
  ];
}