immutable-functions

A simple, easy, straight forward approach to update immutable data.

$ yarn add immutable-functions

or

$ npm install -s immutable-functions

import _i from 'immutable-functions';
import { CREATE, UPDATE, REMOVE } from '../actions/collection';

export default (state = [], action) => {
  switch (action.type) {
    case CREATE:
      return _i.create(state, action.obj);
    case UPDATE:
      return _i.update(state, action.obj.id, action.obj);
    case REMOVE:
      return _i.destroy(state, action.obj.id);
    default:
      return state;
  }
};

import React, { PureComponent } from 'react';
import { View, Text } from 'react-native';
import { connect } from 'react-redux';
import _i from 'immutable-functions';

class YourComponent extends PureComponent {
  render() {
    // Get the item with id === 5
    const item = _i.find(this.props.data, 5)

    // item
    // {
    //   id: 5,
    //   name: Jerry,
    //   email: jerry@gmail.com
    // }

    return (
      <View>
        <Text>Name: {item.name}</Text>
        <Text>Email: {item.email}</Text>
      </View>
    );
  }
}

// Here are the properties of the store this component uses
const mapStoreToProps = store => ({
  data: store.yourReducer
});

// This is how we connect the store to our component
export default connect(mapStoreToProps)(YourComponent);

Functions

_i.create(state, data)

Creates an object if it does not already exist (by id) in the array. - arguments

- **state** *(array)* The current array of objects.
- **data** *(object)* The object you are adding to the array.

• returns

- *(array)* A new array with the new object added to the end

_i.update(state, id, data)

Updates an object if it exists (by id) in the array, if it does not exist, it will create it. - arguments

- **state** *(array)* The current array of objects.
- **id** *(integer)* The id of the object you are updating.
- **data** *(object)* The delta of the object you are updating.

• returns

- *(array)* A new array with the object updated

_i.destroy(state, id)

Destroys an object if it exists (by id) in the array. - arguments

- **state** *(array)* The current array of objects.
- **id** *(integer)* The id of the object you are destroying.

• returns

- *(array)* A new array with the object removed

_i.merge(state, array[, deep])

Merges an object or array of objects (unique by id) with the current state. - arguments

- **state** *(array/object)* The current object or array of objects.
- **array** *(array/object)* new object or array of objects being merged.
- **deep** *(boolean)* will do a deep merge of an object

• returns

- *(array/object)* A new object or array with all the objects unique by `id`

_i.find(state, id)

Find an object if it exists (by id) in the array. Useful in components when accessing the data. - arguments

- **state** *(array)* The current array of objects.
- **id** *(integer)* The id of the object you are finding.

• returns

- *(array)* A single (first) object with the given id

_i.findByProp(state, prop, id)

Find an object if it exists by a property provided in the array. Useful in components when accessing the data. - arguments

- **state** *(array)* The current array of objects.
- **prop** *(string)* The identifier property on the objects in the array.
- **id** *(integer)* The id of the object you are finding.

• returns

- *(array)* A single (first) object with the given identifier property

• example

- `_i.findByProp(state, 'LoanId', '1234456');`

_i.updateByProp(state, prop, id, data)

Updates an object if it exists by an identifier property provided in the array, if it does not exist, it will create it. - arguments

- **state** *(array)* The current array of objects.
- **prop** *(string)* The identifier property on the objects in the array.
- **id** *(integer)* The id of the object you are updating.
- **data** *(object)* The delta of the object you are updating.

• returns

- *(array)* A new array with the object updated

• example

- `_i.updateByProp(state, 'LoanId', action.obj.LoanId, action.obj); `

_i.destroyByProp(state, prop, id)

Destroy an object if it exists by an identifier property provided in the array. - arguments

- **state** *(array)* The current array of objects.
- **prop** *(string)* The identifier property on the objects in the array.
- **id** *(integer)* The id of the object you are updating.

• returns

- *(array)* A new array with the object removed

• example

- `_i.destroyByProp(state, 'LoanId', action.obj.LoanId); `

_i.mergeByProp(state, array, prop[, deep])

Merges an object or array of objects (unique by prop) with the current state. - arguments

- **state** *(array/object)* The current object or array of objects.
- **array** *(array/object)* new object or array of objects being merged.
- **prop** *(string)* The identifier property on the objects in the array.
- **deep** *(boolean)* will do a deep merge of an object

• returns

- *(array/object)* A new object or array with all the objects unique by prop