redux-business-logic-middleare

Middleware for processing business login in redux application.

Instllation

Using npm

1npm install --save-dev @budarin/redux-business-logic-middleare

Using yarn

1yarn add -D @budarin/redux-business-logic-middleare

Using:

Let's implement a simple business rule for Todo: “when creating a todo, send the todo to the server and to the redux store”.

Let's describe the essence of Todo — its constants, actions, business rules and a redeser in accordance with the concept of ducks.

./ducks/todo.js

1import { sendTodo } from 'src/services/api'
2import { onAction } from'@budarin/redux-business-logic-middleare';
3
4const SET_ERROR = 'TODO/SET_ERROR';
5export const ADD_TODO = 'TODO/ADD_TODO';
6
7export const setError = (error) => ({
8    type: SET_ERROR,
9    payload: error
10})
11
12export const addTodo = ( todo ) => ({
13    type: ADD_TODO,
14    payload: todo 
15});
16
17// our business rule
18export const addTodoMiddleware = async (store, next, action) => {
19    // call the API method to send todo to the server
20    try {
21        await sendTodo(action.payload);
22    } catch(error) {
23        return store.dispatch(setError(error));
24    }
25
26     // otherwise, we pass the action to the next middleware
27    return next(action);
28}
29
30// let's add the business rule
31onAction(ADD_TODO, addTodoMiddleware)
32
33
34export default const reducer = (state = initialState, action) => {
35    switch (action.type) {
36        case ADD_TODO: {
37            ...
38        }
39        case SET_ERROR {
40            ...
41        }
42        default:
43            return state;
44    }
45};

Add midleware to stores middlewares

1import todoReducer from '../ducks/todo.js'
2import { createStore, applyMiddleware, combineReducers } from 'redux'
3import { bussinesLogicMiddleware } from '@budarin/redux-business-logic-middleare';
4
5const reducers = combineReducers(
6    ...
7    todoReducer,
8    ...
9);
10
11const store = createStore(
12    reducers, 
13    initialState, 
14    applyMiddleware(bussinesLogicMiddleware)
15);

To remove bussines-rule from processing

1import { ADD_TODO } from '../ducks/todo.js'
2import { offAction } from '@budarin/redux-business-logic-middleare';
3
4offAction(ADD_TODO);

To remove all bussines-rules from processing

1import { removeAllBusinessRules } from '@budarin/redux-business-logic-middleare';
2
3removeAllBusinessRules();