@bunnix/optimistics

Optimistic state control while external data loads, built for Bunnix. It pairs a committed base state with an optimistic state, supports scoped transactions, and integrates with @bunnix/redux style reducers.

Install

npm install @bunnix/optimistics

Basic usage

import { useOptimistics } from '@bunnix/optimistics';

const counter = useOptimistics(0, {
  add: (state, args) => state + args
});

counter.add(1);
console.log(counter.state.get());

Transactional optimistic flow

import { useOptimistics } from '@bunnix/optimistics';

const tasks = useOptimistics([], {
  addTask: (state, args) => (args.task ? [...state, args.task] : state)
});

await tasks.transaction(async (tx) => {
  tx.apply((value) => [...value, { id: 't1', title: 'Ship' }]);
  // await api.save(...)
});

Middleware integration

import { applyMiddlewareOptimistics, useOptimistics } from '@bunnix/optimistics';

const reducers = {
  init: (state, args) => (Array.isArray(args.tasks) ? args.tasks : state),
  addTask: (state, args) => (args.task ? [...state, args.task] : state)
};

const tasks = useOptimistics(
  [],
  applyMiddlewareOptimistics(async (event, args, nextState, next) => {
    if (event === 'addTask') {
      // await api.save(nextState)
    }
    if (next) await next();
  })(reducers)
);