madbean/cqrs-redux

A starter kit for fast development using CQRS DDD Eventsourcing and Redux for the read models

Introduction

This is a in-memory CQRS Starter kit with the read model built using redux store.

• nodeCqrs I based my implementation on it.
• node-eventstore for EventSourcing.

get it up and running

npm start

Write side

• Each module (Bounded Context) should live in a folder inside the domain folder.

• Each module has handlers (mappers) which apply functions like

( aggregateRoot, command) -> [events]

• Each module has reducers which are used to reconstruct the state of the aggregate base on their event stream

Read side

The read model is a series of Redux reducers

BDD Tests

The project implements a helper library to test the domain aggregates using a BDD like language. This implementation was based on cqrs-starter-kit for .NET

The test can expect events:

it('Should Return Event Item Created', function() {
    Test(
      given(),
      when({
          command: 'createItem',
          aggId: '123',
          payload:{
            text: 'This is a new Item'
          }
      }),
      then({
          event: 'itemCreated',
          payload:{
            itemId: '123',
            text: 'This is a new Item'
          }
      })
    )
});

Or errors:

it('Should Give Error', function() {
    Test(
      given(),
      when({
          command: 'changeItem',
          aggId: '123',
          payload:{
            text: 'This is a new Item'
          }
      }),
      thenFailWith(new errors.ItemDoesNotExists())
    )
});