Redux Toolkit Extended entityAdapter

This is a fork of the official official reduxjs/redux-toolkit repo. It extends createEntityAdapter with some additional utils.

See original README

See createEntityAdapter docs

Additional createEntityAdapter features

createEntityAdapter({initialState})

Improves API to setting initial sate, see https://github.com/reduxjs/redux-toolkit/issues/493#issuecomment-612471868

initialState can be multiple shapes and will all return EntityState

1const one = [{ id: 1, title: 'The Hobbit' }]
2const two =  { 1 : { id: 1, title: 'The Hobbit' } }
3const three = { ids: [1], entities: { 1: { id: 1, title: 'The Hobbit' } }

Example

1const initialState = [{ id: 1, title: 'The Hobbit' }]
2
3const bookAdapter = createEntityAdapter({ initialState })
4
5bookAdapter.getInitialState() // { ids: [1], entities: { 1: { id: 1, title: 'The Hobbit' } }

getSelectors().selectByIdOrThrow

Throws if selected entity is not found. Useful for when a the passed entity id will be known, to reduce unnecessary undefined checks.

getSelectors().selectByIds

(TODO) getSelectors().selectAll(state, filterPredicate)

Installing

1yarn add @didley/reduxjs-toolkit

reduxjs/redux-toolkit is not required and can be uninstalled