cerebral-immutable-store

Immutable Store Model layer for Cerebral

The Cerebral Webpage is now launched

You can access the webpage at http://christianalfoni.com/cerebral/

Debugger

You can download the Chrome debugger here.

Install

npm install cerebral-immutable-store

Instantiate a Cerebral controller

controller.js

import Controller from 'cerebral';
import Model from 'cerebral-immutable-store';
import request from 'superagent';

// The initial state of the application
const model = Model({
  isLoading: false,
  user: null,
  error: null
});

// Any services you want each action to receive
const services = {
  request: request
};

// Instantiate the controller
export default Controller(model, services);

With immutable-store you can also map state using functions, read more about that here.

Creating signals

Creating actions are generic. It works the same way across all packages. Please read about actions at the Cerebral Repo - Actions. You can also watch a video on signals to get an overview of how it works.

Typically you would create your signals in the main.js file, but you can split them out as you see fit.

main.js

import controller from './controller.js';

import setLoading from './actions/setLoading.js';
import saveForm from './actions/saveForm.js';
import unsetLoading from './actions/unsetLoading.js';

controller.signal('formSubmitted', setLoading, [saveForm], unsetLoading);

Listening to changes

You can manually listen to changes on the controller, in case you want to explore reactive-router for example.

main.js

import controller from './controller.js';

const onChange = function () {
  controller.get() // New state
};
controller.on('change', onChange);
controller.removeListener('change', onChange);

// When debugger traverses state
controller.on('remember', onChange);
controller.removeListener('remember', onChange);

Listening to errors

You can listen to errors in the controller. Now, Cerebral helps you a lot to avoid errors, but there are probably scenarios you did not consider. By using the error event you can indicate messages to the user and pass these detailed error messages to a backend service. This lets you quickly fix bugs in production.

main.js

...
const onError = function (error) {
  controller.signals.errorOccured({error: error.message});
  myErrorService.post(error);
};
controller.on('error', onError);