Async-Box

AsyncBox is a library for your main application object, it supports Sync and Async APIs

Requires runtime with Map and Promise APIs available. Node 4+ and evergreen browsers are the best option.

Promise can be polifilled with Bluebird library.

App object provides own API plus evented EventEmitter API

Install:

npm install async-box

Use:

1// create app object
2var AsyncBox = require('async-box');
3var app = new AsyncBox();

Async API:

1app.respondAsync('some-request-name', function(requestData) {
2    // response can be any plain JavaScript value, object or ...
3    return 'response-text';
4});
5
6app.respondAsync('async-promise-request', function(requestData) {
7    // ... or Promise
8    return new Promise(function(resolve, reject) {
9        resolve('response-promise');
10    });
11});
12
13app.requestAsync('some-request-name').then(function(response) {
14    console.log(response); // -> 'response-text'
15});
16
17app.requestAsync('async-promise-request').then(function(response) {
18    console.log(response); // -> 'response-promise'
19});

Sync API:

1app.respondSync('some-sync-request', function(request-data) {
2    // response is any valid JavaScript value
3    return 'some-response-value';
4});
5
6const response = app.requestSync('some-sync-request');
7console.log(response); // -> 'some-response-value'

Batch API:

Async:

1app.respondAsync('request-type-one', function(requestData) {
2    console.log(requestData); // -> { key: 'some-value' }
3    // it could be any amount of code here,
4    // the main rule is to return a Promise
5    return new Promise(function(resolve, reject) {
6        resolve('one');
7    });
8});
9
10app.respondAsync('request-type-two', function(requestData) {
11    console.log(requestData); // -> { key: 'other-value' }
12    return new Promise(function(resolve, reject) {
13        resolve('two');
14    });
15});
16
17app.requestAllAsync([
18    ['request-type-one', { key: 'some-value' }],
19    ['request-type-two', { key: 'other-value' }],
20]).then(function(results) {
21    console.log(results); // -> ['one', 'two']
22});

Sync:

1app.respondSync('sync-request-one', function(requestData) {
2    console.log(requestData); // -> { key: 'sync-one' }
3    return 'sync-one';
4});
5
6app.respondSync('sync-request-two', function(requestData) {
7    console.log(requestData); // -> { key: 'sync-two' }
8    return 'sync-two';
9});
10
11const responses = app.requestAllSync([
12    ['sync-request-one', { key: 'sync-one' }],
13    ['sync-request-two', { key: 'sync-two' }],
14]);
15
16console.log(responses); // ['sync-one', 'sync-two']

License

MIT © Yury Solovyov