redux-action-generate

Generates reducers and actions from one reducers list.

Install:

yarn add redux-action-generate

import reduxActionGenerate from 'redux-action-generate';

'reduxActionGenerate' function signature:

_

1Common object argument that is passed to 'reduxActionGenerate' function:
2{
3// *required 
4// array of reducers;
5 reducers = [
6   {
7      // *required
8      // name of reducer
9      name: 'users',
10      // *required
11      // name for action's dispatch type 
12      basicType: constants.COMMON,
13      // initial state for this specific reducer
14      initialState: authInitialState,
15      // specific config for redux-persist lib
16      config: usersPersistConfig,
17      // reducer's handlers for some specific action's type 
18      handlers: {
19         [constants.LOGIN + '_CUSTOM']: (state, action) => ({ ...state }),
20         [constants.LOGIN + '_CUSTOM2']: (state, action) => {
21           return { ...state };
22         },
23         [constants.LOGIN + '_CUSTOM3']: (state, action) => {
24           return { ...state };
25         },
26       },
27     },
28    },
29    {
30    ...
31    }
32 ],
33 
34 // any redux middlewares;
35 middlewares = [],
36 
37 // initial state for 'configureStore' redux api funcrtion;
38 initialState = {},
39 
40 // config object for redux-persist library
41 persistConfig = defaultPersistConfig,
42 
43 // function which inserts custom headers to 
44 // api calls made with A.dispatch[<reducer name>][<Get/Post/Put/Patch/Delete>] 
45 // returns an object
46 // i.e. A.dispatchCommonGet({url: 'http...'})
47 apiCallCustomHeaders,
48 
49 // function which inserts custom 'catch' behaviour on each http request
50 commonCatchFunc,
51}

Example:

_

1// receives error as an argument
2function commonCatchFunc(err) {
3 if (err.response.status) === 401) {
4   logout();
5 }
6}
7
8// receives store where you can get 'store.getState().token' to insert it in each request
9// must return an object
10function apiCallCustomHeaders(store) {
11 let headers = {
12   'Content-Type': 'application/json',
13   'Authorization': store.getState().token
14 };
15 return headers;
16}
17
18// common config for redux-persist - to save info locally - is not required
19const persistConfig = {
20 key: 'root',
21 whitelist: ['token'],
22 storage: storage,
23 stateReconciler: autoMergeLevel2,
24};
25
26export const { 
27   store, 
28   persistor, 
29   A 
30} = reduxActionGenerate({
31 reducers,
32 apiCallCustomHeaders,
33 commonCatchFunc,
34 persistConfig,
35});

Features

• all reducers are generated from an array of objects - each for specific reducer - no need for separate files;
• for each reducer there is a bunch of default actions generated:
• naming convention - A. + 'dispatch' + name of reducer (in this case name was 'common') /+ possible actions
• no mess with files for each reducer + file for each action creator
• each bunch of actions for each reducer has:

1. common dispatcher - A.dispatchCommon({ 'config[0].locale': 'en'}) - can set values on any depth (thanks to lodash set with no mutation under the hood)
2. A.dispatchCommonClear() - set initial state on reducer
3. A.dispatchCommonError({error: error}) - set error on reducer (but can be done with the first method)
4. Bunch of methods for ajax request (with axios)

1A.dispatchCommonPost({
2    url: 'https://...',
3    data: data,
4    
5    // may be omitted - if 'format' function is not provided - all response will 
6    // be injected in reducer as is
7    format: (response) => { 
8        // do what uyou need with the response
9        // if don't want to inject anything in reducer - return empty object
10    }
11})