redux-sleep v0.5.2

redux-sleep

Simple structure to redux reducers to help speed up development.

Convention over configuration approach to redux reducers which face RESTful endpoints.

Install

Get started by installing hobson (and mongoose, if you haven't already).

npm install --save redux redux-sleep

To use the thunk functions; you must also install redux-thunk.

npm install --save redux-thunk

Usage

Create the resource.

const listingResource = new Resource({
  scope: 'appName',
  name: 'listing',
  key: '_id', // id key on the items
  state: {
    person: 'fred',
    extra: 'options',
    initial: ['state'],
  },
});

// code...

export default listingResource;

Define custom methods.

listingResource.addMethod('changePerson', (state, { payload = null }) => ({
  ...state,
  person: payload,
}))

Define custom thunks.

listingResource.addThunk('getPeople', () => resource => async (dispatch, getState) => {
  const { token } = getState().user.auth;
  const person = await apiGetRandomPerson(token);
  dispatch(resource.action('changePerson')(person));
  return { person };
});

Add the reducers to the redux state.

const reducers = {
  listing: listingResource.reducer,
};

Get the actions and thunks from the resource.

const mapDispatchToProps = {
  patchListing: listingResource.action('patch'),
  getListings: listingResource.thunk('getListings'),
};

Use the functions!

this.props.patchListing({ hello: 'there' });

Initial State

Initial state which is provided.

{
  [pluralName]: [], // e.g. listings: []
  [singularName]: null, // e.g. listing: null
  problem: null, // will be filled with error object
  loading: false,
  success: null,
}

Methods Provided

List of the methods which the resource provides by default.

Maintainers

• Jack Scott