couchbase-promises

Couchbase Promises

A lightweight, drop-in replacement for the Couchnode module with added support for A+ Promises.

Overview

Just like the Couchbase Node.js module, but with the addition of *Async() methods that return A+ Promises for all methods that contain a Node.js callback parameter. Both the normal Couchnode and the mock Couchnode APIs have been fully promisified.

The current version supports Couchbase Node.js SDK version 2.1.2.

Promises are created using the Bluebird Promises library.

General Usage

Usage is almost exactly the same as the native SDK, but with the added ability to use Promises instead of callbacks.

A user repository module with a simple lookup...

var couchbase = require('couchbase-promises');
var cluster = new couchbase.Cluster('couchbase://127.0.0.1');
var bucket = cluster.openBucket();

function UserNotFoundError() {
  Error.call(this);
  Error.captureStackTrace(this, UserNotFoundError);
  this.message = "User not found.";
}

module.exports = {
  UserNotFoundError: UserNotFoundError,
  getUserAsync: function(userId) {
    return bucket.getAsync(userId)
      .then(function(result) {
        return {
          user: result.value,
          meta: {
            etag: result.cas
          }
        };
      }).catch(couchbase.Error, function(e) {
        if (e.code == couchbase.errors.keyNotFound)
          throw new UserNotFoundError();

        throw e;
      });
  }
};

Changelog

1.0.0

• Initial release.