db-core/mutations-optimistic

Implement optimistic mutations in TanStack DB using createOptimisticAction for synchronous updates and createTransaction to batch insert, update, and delete operations. This coordinates fast UI with eventual server state persistence.

Transactional batching groups multiple insert, update, and delete operations into a single ambient transaction. Use it when you need reliable optimistic updates and eventual server consistency without blocking UI responsiveness.

Yes, use createPacedMutations to debounce, throttle, or queue persistence operations. This allows you to control how quickly optimistic frontend state changes sync to the backend.

The Transaction lifecycle tracks pending, persisting, completed, and failed states using Transaction.isPersisted. This manages the PendingMutation type and applies merging rules to resolve conflicts during backend sync.

Yes, TanStack DB supports Immer-style draft proxies for insert, update, and delete operations. It provides onInsert, onUpdate, and onDelete handlers to manage optimistic state changes within ambient transactions.