redux-graphql

Redux GraphQL Integration

Running demo (NodeJS)

$ npm run server
$ npm run demo

install

npm i -S redux-graphql

Concepts

Query associated models using GraphQL, and automatically keep them normalized in the store:

Use selectors to query the store and get models back into your components:

usage

Include the reducer and middleware:

// rootReducer.js
import { graphqlReducer } from 'redux-graphql';

rootReducer = combineReducers({
  graph: graphqlReducer()
});

// store
import { graphqlMiddleware } from 'redux-graphql';
middelwares = [
 ...,
 graphqlMiddleware
];

Create Request Actions, that will fetch the data, and put it on the store normalized (flat):

import { graphqlRequestAction } from 'redux-graphql';
import getCampaignsQuery from './queries/get-campaigns.gql';
import createCampaignsQuery from './queries/create-campaign.gql';

export const getCampaigns = graphqlRequestAction(getCampaignsQuery);

Custom success callback, and calling actions that maniuplate the state, directly:

// Either set the data after create:
export const createCampaign = graphqlActionCreator(createCampaignsQuery, {
  onSuccess: (data, dispatch) => dispatch(graphqlSet('Campaign', data.id, data))
});

// Or call get campaigns again:
const createCampaign = graphqlActionCreator(getCampaignsQuery, {
  onSuccess: (data, dispatch) => dispatch(getCampaigns())
});

Use the actions and selector in the component:

// component
import { selectAll, graphqlDeleteAll } from 'redux-graphql';
import { getCampaigns, createCampaign } from './actions/campaign-actions';

class CampaignsList extends React.Component {
  componentDidMount() {
    // get / refresh data
    this.props.getCampaigns();
  }
  componentWillUnmount() {
    // clear data
    this.props.graphqlDeleteAll('Campaign');
  }
  onCreate(campaignData) {
    this.props.createCampaign({ campaign: campaignData }); // Whatever is passed to the action will be used as variables
  }
  render() {
    return this.props.campaigns.map(...)
  }
}

const mapStateToProps = (state) => {
  // get denormalized campaign, with all publishers and their ads:
  campaigns: selectAll(state.graphql, 'Campaign', { Publisher: { Ad: {} } })
};
export default connect(mapStateToProps, {
  getCampaigns,
  graphqlClear
})(CampaignsList);

normalizing

To be able to normalize we need to know for each resource if it should be normalized and by which key. We use an alias in graphql query to denote the key __redux_key we also query __typename to know under which resource to store the results.

For example:

query getCampaigns() {
  campaigns {
    id
    __typename
    __redux_key: id
    title
    description
    publishers {
      name
      __typename
      __redux_key: name
      campaignId
      budget
      ads {
        id
        __redux_key: id
        __typename
        publisherName
        campaignId
        image {
          // doesn't normalize
          id
          url
          width
          height
        }
      }
    }
  }
}

Will be stored like so:

{
  Campaign: {
    1: {
      id: 1,
      __typename: 'Campaign',
      __redux_key: 1,
      title: '...',
      description: '...',
      publishers: [
        { __redux_resource: 'Publisher', key: 'Google' },
        { __redux_resource: 'Publisher', key: 'Facebook' }
      ]
    }
  },
  Publisher: {
    Google: {
      name: 'Google',
      __typename: 'Publisher',
      __redux_key: 'Google',
      campaignId: 1,
      budget: 1000,
      ads: [
        { __redux_resource: 'Ad', key: 1 }
      ]
    },
    Facebook: {...}
  },
  Ad: {
    id: 1,
    __redux_key: 1,
    __typename: 'Ad',
    publisherName: 'Google',
    campaignId: 1,
    image: {
      id: 1,
      url: 'http://my.image',
      width: 100,
      height: 100
    }
  }
}

Denormalizing using selectors

Denormalizing using the same graphql strings to instruct the selector which parts should be denormalized. For example:

const denormalizer = {
  Publisher: {}
}

selectGrahpql(state, 'Campaign', 1, denormalizer) // using above state

Will produce the denormalized object:

{
  id: 1,
  __typename: 'Campaign',
  __redux_key: 1,
  title: '...',
  description: '...',
  publishers: [
    {
      name: 'Google',
      __typename: 'Publisher',
      __redux_key: 'Google',
      campaignId: 1,
      budget: 1000,
      ads: [
        { __redux_resource: 'Ad', key: 1 }
      ]
    },
    { ... }
  ]
}