New: First implementation

.jshintrc

@@ -0,0 +1,5 @@
+{
+  "node": true,
+  "strict": true,
+  "eqnull": true
+}

README.md

@@ -4,3 +4,25 @@ async-settle
 [![build status](https://secure.travis-ci.org/phated/async-settle.png)](http://travis-ci.org/phated/async-settle)
 
 Settle your async functions - when you need to know all your parallel functions are complete (success or failure)
+
+## API
+
+### `settle(executor, onComplete)` : Function
+
+Takes a function to execute (`executor`) and a function to call on completion (`onComplete`).
+
+`executer` is executed in the context of [`async-done`](https://github.com/phated/async-done), with all errors and results being settled.
+
+`onComplete` will be called with a settled value.
+
+#### Settled Values
+
+Settled values have two properties, `state` and `value`.
+
+`state` has two possible options `'error'` and `'success'`.
+
+`value` will be the value passed to original callback.
+
+## License
+
+MIT

index.js

@@ -0,0 +1,21 @@
+'use strict';
+
+var asyncDone = require('async-done');
+
+function settle(fn, done){
+  asyncDone(fn, function(error, result){
+    var settled = {};
+
+    if(error != null){
+      settled.state = 'error';
+      settled.value = error;
+    } else {
+      settled.state = 'success';
+      settled.value = result;
+    }
+
+    done(undefined, settled);
+  });
+}
+
+module.exports = settle;

package.json

@@ -0,0 +1,36 @@
+{
+  "name": "async-settle",
+  "version": "0.0.0",
+  "description": "Settle your async functions - when you need to know all your parallel functions are complete (success or failure)",
+  "main": "index.js",
+  "directories": {
+    "test": "test"
+  },
+  "scripts": {
+    "test": "tap ./test"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/phated/async-settle"
+  },
+  "keywords": [
+    "settle",
+    "async",
+    "async-done",
+    "complete",
+    "error",
+    "parallel"
+  ],
+  "author": "Blaine Bublitz <[email protected]> (http://iceddev.com/)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/phated/async-settle/issues"
+  },
+  "homepage": "https://github.com/phated/async-settle",
+  "devDependencies": {
+    "tap": "^0.4.8"
+  },
+  "dependencies": {
+    "async-done": "^0.2.0"
+  }
+}

test/index.js

@@ -0,0 +1,31 @@
+'use strict';
+
+var test = require('tap').test;
+
+var settle = require('../');
+
+test('should transform success into settled success values', function(t){
+  var val = 'value to be settled';
+  settle(function(done){
+    done(null, val);
+  }, function(error, result){
+    t.notOk(error, 'error should be undefined');
+    t.ok(result, 'result should be defined');
+    t.ok(result.state === 'success', 'state should be "success"');
+    t.equal(result.value, val, 'value should be the success value');
+    t.end();
+  });
+});
+
+test('should transform errors into settled success values', function(t){
+  var err = new Error('Error to be settled');
+  settle(function(done){
+    done(err);
+  }, function(error, result){
+    t.notOk(error, 'error should be undefined');
+    t.ok(result, 'result should be defined');
+    t.ok(result.state === 'error', 'state should be "error"');
+    t.equal(result.value, err, 'value should be the error value');
+    t.end();
+  });
+});