.travis.yml

@@ -1,4 +1,5 @@
 language: node_js
 node_js:
-  - "0.8"
   - "0.10"
+  - "0.12"
+  - "4.1"

README.md

@@ -21,14 +21,24 @@ Common error classes and utility functions
 * [ArgumentError](#argument)
 * [ArgumentNullError](#argumentnull)
 * [AuthenticationRequiredError](#authrequired)
+* [ConnectionError](#connection)
+* [DataError](#data)
+  * [MemcacedError](#memcached)
+  * [MongoDBError](#mongodb)
+  * [RedisError](#redis)
+  * [RollbackError](#rollback)
+  * [SQLError](#sql)
+  * [TransactionError](#transaction)
 * [Error](#error)
 * [HttpStatusError](#httpstatus)
+* [InvalidOperationError](#invalidoperation)
 * [IOError](#io)
   * [DirectoryNotFoundError](#directorynotfound)
   * [DriveNotFoundError](#drivenotfound)
   * [EndOfStreamError](#endofstream)
   * [FileLoadError](#fileload)
   * [FileNotFoundError](#filenotfound)
+  * [SocketError](#socket)
 * [NotFoundError](#notfound)
 * [NotImplementedError](#notimplemented)
 * [NotPermittedError](#notpermitted)
@@ -38,6 +48,7 @@ Common error classes and utility functions
 * [ReferenceError](#reference)
 * [StackOverflowError](#stackoverflow)
 * [SyntaxError](#syntax)
+* [TimeoutError](#timeout)
 * [TypeError](#type)
 * [URIError](#uri)
 * [ValidationError](#validation)
@@ -132,6 +143,158 @@ throw new errors.AuthenticationRequiredError("Please provide authentication.", e
 
 ---------------------------------------
 
+<a name="connection" />
+### ConnectionError
+
+Applicable when an error occurs on a connection.
+
+	new ConnectionError(message[, inner_error])
+
+__Arguments__
+
+* `message` - any message
+* `inner_error` - the Error instance that caused the current error. Stack trace will be appended.
+
+```js
+// Example
+throw new errors.ConnectionError('database connection no longer available', err);
+```
+
+---------------------------------------
+
+<a name="data" />
+### DataError
+
+Applicable when an error occurs on or with an external data source.
+
+	new DataError(message[, inner_error])
+
+__Arguments__
+
+* `message` - any message
+* `inner_error` - the Error instance that caused the current error. Stack trace will be appended.
+
+```js
+// Example
+throw new errors.data.DataError('Too many rows returned from database', err);
+```
+
+---------------------------------------
+
+<a name="memcached" />
+### MemcachedError
+
+Applicable when an error occurs while using memcached.
+
+	new MemcachedError(message[, inner_error])
+
+__Arguments__
+
+* `message` - any message
+* `inner_error` - the Error instance that caused the current error. Stack trace will be appended.
+
+```js
+// Example
+throw new errors.data.MemcachedError('Expected value not found', err);
+```
+
+---------------------------------------
+
+<a name="mongodb" />
+### MongoDBError
+
+Applicable when an error occurs while using MongoDB.
+
+	new MongoDBError(message[, inner_error])
+
+__Arguments__
+
+* `message` - any message
+* `inner_error` - the Error instance that caused the current error. Stack trace will be appended.
+
+```js
+// Example
+throw new errors.data.MongoDBError('Retrieved value not in expected format', err);
+```
+
+---------------------------------------
+
+<a name="redis" />
+### RedisError
+
+Applicable when an error occurs while using redis.
+
+	new RedisError(message[, inner_error])
+
+__Arguments__
+
+* `message` - any message
+* `inner_error` - the Error instance that caused the current error. Stack trace will be appended.
+
+```js
+// Example
+throw new errors.data.RedisError('expected value not found in redis', err);
+```
+
+---------------------------------------
+
+<a name="rollback" />
+### RollbackError
+
+Applicable when a transaction was unexpectedly rolled back.
+
+	new RollbackError(message[, inner_error])
+
+__Arguments__
+
+* `message` - any message
+* `inner_error` - the Error instance that caused the current error. Stack trace will be appended.
+
+```js
+// Example
+throw new errors.data.RollbackError('database transaction was unexpectedly rolled back', err);
+```
+
+---------------------------------------
+
+<a name="sql" />
+### SQLError
+
+Applicable when an error occurs while using a SQL database.
+
+	new SQLError(message[, inner_error])
+
+__Arguments__
+
+* `message` - any message
+* `inner_error` - the Error instance that caused the current error. Stack trace will be appended.
+
+```js
+// Example
+throw new errors.data.SQLError('foreign key constraint violated', err);
+```
+
+---------------------------------------
+
+<a name="transaction" />
+### TransactionError
+
+Applicable when an error unexpectedly interrupts a transaction.
+
+	new TransactionError(message[, inner_error])
+
+__Arguments__
+
+* `message` - any message
+* `inner_error` - the Error instance that caused the current error. Stack trace will be appended.
+
+```js
+// Example
+throw new errors.data.TransactionError('transaction already complete', err);
+```
+
+---------------------------------------
+
 <a name="error" />
 ### Error
 
@@ -187,6 +350,25 @@ throw new errors.HttpStatusError(err, req);
 
 ---------------------------------------
 
+<a name="invalidoperation" />
+### InvalidOperationError
+
+Applicable when an invalid operation occurs.
+
+	new InvalidOperationError(message[, inner_error])
+
+__Arguments__
+
+* `message` - any message
+* `inner_error` - the Error instance that caused the current error. Stack trace will be appended.
+
+```js
+// Example
+throw new errors.InvalidOperationError('divide by zero', err);
+```
+
+---------------------------------------
+
 <a name="io" />
 ### IOError
 
@@ -301,6 +483,25 @@ throw new errors.io.FileNotFoundError("./package.json", err)
 
 ---------------------------------------
 
+<a name="socket" />
+### SocketError
+
+Applicable when an error occurs on a socket.
+
+	new SocketError(message[, inner_error])
+
+__Arguments__
+
+* `message` - any message
+* `inner_error` - the Error instance that caused the current error. Stack trace will be appended.
+
+```js
+// Example
+throw new errors.SocketError('socket no longer available', err);
+```
+
+---------------------------------------
+
 <a name="notfound" />
 ### NotFoundError
 
@@ -472,6 +673,25 @@ throw new errors.SyntaxError("Unexpected token a", err);
 
 ---------------------------------------
 
+<a name="timeout" />
+### TimeoutError
+
+Applicable when an operation takes longer than the alloted amount.
+
+	new TimeoutError(time[, inner_error])
+
+__Arguments__
+
+* `time` - a time duration
+* `inner_error` - the Error instance that caused the current error. Stack trace will be appended.
+
+```js
+// Example
+throw new errors.TimeoutError('100ms', err);
+```
+
+---------------------------------------
+
 <a name="type" />
 ### TypeError
 
@@ -680,3 +900,4 @@ The above copyright notice and this permission notice shall be included in all c
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 
+

index.js

@@ -14,8 +14,10 @@ exports.AlreadyInUseError = exports.AlreadyInUse = require('./lib/alreadyInUse')
 exports.ArgumentError = exports.Argument = require('./lib/argument');
 exports.ArgumentNullError = exports.ArgumentNull = require('./lib/argumentNull');
 exports.AuthenticationRequiredError = exports.AuthenticationRequired = require('./lib/authenticationRequired');
+exports.ConnectionError = exports.helpers.generateClass('ConnectionError');
 exports.Error = exports.helpers.generateClass('Error');
 exports.HttpStatusError = exports.HttpStatus = require('./lib/http-status');
+exports.InvalidOperationError = require('./lib/invalid-operation');
 exports.NotFoundError = require('./lib/not-found');
 exports.NotImplementedError = exports.helpers.generateClass('NotImplementedError'),
 exports.NotSupportedError = exports.NotSupported = require('./lib/not-supported');
@@ -25,6 +27,7 @@ exports.RangeError = exports.helpers.generateClass('RangeError', { extends: Rang
 exports.ReferenceError = exports.helpers.generateClass('ReferenceError', { extends: ReferenceError });
 exports.StackOverflowError = exports.helpers.generateClass('StackOverflowError');
 exports.SyntaxError = exports.helpers.generateClass('SyntaxError', { extends: SyntaxError });
+exports.TimeoutError = require('./lib/timeout.js')
 exports.TypeError = exports.helpers.generateClass('TypeError', { extends: TypeError });
 exports.URIError = exports.helpers.generateClass('URIError', { extends: URIError });
 exports.ValidationError = exports.Validation = require('./lib/validation');
@@ -37,6 +40,18 @@ exports.io.DriveNotFoundError = exports.helpers.generateClass('DriveNotFoundErro
 exports.io.EndOfStreamError = exports.helpers.generateClass('EndOfStreamError', { extends: exports.io.IOError });
 exports.io.FileLoadError = require('./lib/io/file-load');
 exports.io.FileNotFoundError = require('./lib/io/file-not-found');
+exports.io.SocketError = exports.helpers.generateClass('SocketError', { extends: exports.io.IOError });
+
+exports.data = {
+  DataError: require('./lib/data/data')
+};
+exports.data.MemcachedError = exports.helpers.generateClass('MemcachedError', { extends: exports.data.DataError });
+exports.data.MongoDBError = exports.helpers.generateClass('MongoDBError', { extends: exports.data.DataError });
+exports.data.RedisError = exports.helpers.generateClass('RedisError', { extends: exports.data.DataError });
+exports.data.RollbackError = exports.helpers.generateClass('RollbackError', { extends: exports.data.DataError });
+exports.data.SQLError = exports.helpers.generateClass('SQLError', { extends: exports.data.DataError });
+exports.data.TransactionError = exports.helpers.generateClass('TransactionError', { extends: exports.data.DataError });
+
 
 
 exports.Generic = exports.helpers.generateClass('GenericError'); //deprecated

lib/data/data.js

@@ -0,0 +1 @@
+module.exports = require('../helpers/class-generator')('DataError');

lib/helpers/class-generator.js

@@ -1,5 +1,4 @@
 var util = require('util');
-var _ = require('lodash');
 var globalize = require('../internal/globalize');
 
 module.exports = function generateErrorClass(name, options){
@@ -26,9 +25,17 @@ module.exports = function generateErrorClass(name, options){
     Class.captureStackTrace(this, Class);
   };
 
-  var classGeneratorFn = new Function('classConstructor',
-    "return function " + name + "(" + options.args.join(', ') + "){ classConstructor.apply(this, arguments); };"
-  );
+  var classGeneratorFn = new Function('classConstructor', [
+    "return function ", name, "(", options.args.join(', '), "){",
+      "if(!(this instanceof ", name, ")) {",
+        "var instance = Object.create(", name, ".prototype);",
+        "classConstructor.apply(instance, arguments);",
+        "return instance;",
+      "} else {",
+        "classConstructor.apply(this, arguments);",
+      "}",
+    "};",
+  ].join(''));
   var Class = classGeneratorFn(classConstructor);
 
   util.inherits(Class, options.extends);