universal-composable v1.2.2

Universal Composable

Use middleware in the browser in the "same" way you do in node. This Library is super light and small and more updates are on the way.

If you ever needed to execute functions in a sequence this can help you control the flow in and keep your code clean.

Usage

Node

The library injects 3 args in the following order:

• value: is the result from the previous middleware
• next: function that calls the next middleware in the stack. you have to make sure you invoke next(your-argument) on each middleware in order to move the flow forward.
• abort: function that stops the flow giving you a chance to stop things if no further execution is required or simply gracefully handle errors.

npm install universal-composable --save

const composable = require('composable').composable;

const middleware1 = (value, next, abort) => fetch('my.data.com')
                          .then(response=>response.json())
                          .then(next(data))
                        .catch(abort)
const middleware2 = (value, next, abort) => {
        //parse data or work with it in some way
        //...
        value = Object.assign({}, value, { newData:'Something added/modified' })
        next(value);
}

const middleware3 = (value, next, abort) => {
  //now value has data from middleware1 & middleware2
  fetch("/my.data.com", {
    method: "POST",
    body: value
  });
}

//super nicely execute your middleware functions in a sequential manner.
composable.use(
  middleware1,
  middleware2,
  middleware3
)

Using custom initial values and bindings is also supported in version v1.2.0

var middleware1 = function(result, next, abort) {
  var initTotal = this.a + result;
  //initTotal is currently = 4;
  next(initTotal);
};

var middleware2 = function(result, next, abort) {
  var total = result + 2;
  //total is equal to 6
  next(total);
};

var middleware3 = function(result) {
  //do something with result currently equal to 6.
  fetch(`http://my.data.com/id=${result}`)
    .then(response=>response.json())
    .then(response=> {
      //your custom code
    })
};

var initialValues = {
  a:2,
  b:3
};

var compose = new Composable();
compose.use(
  middleware1.bind(initialValues, 2, compose.next, compose.abort),
  middleware2,
  middleware3
);

Browser & CDN

You can use AMD or simply drop a script tag with dist/composable.min.js and work with in the same way you do in node. or use the CDN https://unpkg.com as

    <!-- Latest version -->
   <script src="https://unpkg.com/universal-composable/umd/composable.min.js"></script>
   <!-- or specific version example: @1.2.1 -->
   <script src="https://unpkg.com/universal-composable@version/umd/composable.min.js"></script>