power-reducers v1.0.3

power-reducers

power-reducers is a set of creators of useful and commonly used reducers. It can work in redux-based application and with react hooks.

It's lightweight, dependency-free, ready for typescript and you can easily integrate it with your existing project as well as get rid of it.

Example 1

counter

Define your reducer

// reducers.js
import { combineReducers } from "redux";
import { createReducer } from "power-reducers/counter";

const [pendingRequests] = createReducer({
  initial: 0,
  incrementOn: [
    "FETCHING_USERS",
    "FETCHING_SETTINGS",
    "FETCHING_PRODUCTS"
  ],
  decrementOn: [
    "FETCHING_USERS_SUCCESS",
    "FETCHING_SETTINGS_SUCCESS",
    "FETCHING_PRODUCTS_SUCCESS",
    "FETCHING_USERS_ERROR",
    "FETCHING_SETTINGS_ERROR",
    "FETCHING_PRODUCTS_ERROR"
  ],
  resetOn: "CANCEL_ALL_REQUESTS"
});

export default combineReducers({
  // ...
  pendingRequests
});

And dispatch your actions

// initial state - counter: 0
dispatch({ type: "FETCHING_USERS" }); // counter: 1
dispatch({ type: "FETCHING_PRODUCTS" }); // counter: 2
dispatch({ type: "FETCHING_USERS_SUCCESS" }); // counter: 1
dispatch({ type: "CANCEL_ALL_REQUEST" }); // counter: 0
// ...

See more counter API and examples

Example 2

list

Define your reducer

// products/reducers.js
import { combineReducers } from "redux";
import { createReducer } from "power-reducers/list";

const [products] = createReducer({
  idName: "uuid",
  initial: [],
  setOn: "SET_PRODUCTS",
  removeOn: "REMOVE_PRODUCTS",
  addOn: ["ADD_PRODUCT", "ADD_PRODUCTS"]
});

export default combineReducers({
  // ...
  products
});

And dispatch your actions

/*
  // initial state:
  products: {
    byId: {},
    allIds: []
  }
*/

dispatch({
  type: "SET_PRODUCTS",
  payload: [
    { uuid: "p1", name: "product 1" },
    { uuid: "p2", name: "product 2" }
  ]
});
/*
  products: {
    byId: {
      'p1': { uuid: 'p1', name: 'product 1' },
      'p2': { uuid: 'p2', name: 'product 2' }
    },
    allIds: ['p1', 'p2']
  }
*/

dispatch({
  type: "ADD_PRODUCT",
  payload: { uuid: "p3", name: "product 3" }
});
/*
  products: {
    byId: {
      'p1': { uuid: 'p1', name: 'product 1' },
      'p2': { uuid: 'p2', name: 'product 2' },
      'p3': { uuid: 'p2', name: 'product 2' }
    },
    allIds: ['p1', 'p2', 'p3']
  }
*/

You can handle more actions, like removing, updating, clearing as well as define your own. See more list API and examples

Documentation

• counter
• toggle
• value
• set-simple
• task-simple
• list

Installation

npm install --save power-reducers

Caution

By default power-reducers is written in ECMAScript 2018 language standard and it is recommended that you transpile it inside your project by your own (using ex. @babel/preset-env).

If you need older EcmaScript version (ex. when errors during webpack build), then import it from es2015 directory:

// import transpiled EcmaScript 2015 version
import { createReducer } from "power-reducers/es2015/list";