First push.

Author: dsfields

.eslintrc

@@ -0,0 +1,95 @@
+{
+  "env": {
+    "node": true
+  },
+  "rules": {
+    "eol-last": 0,
+    "no-alert": 2,
+    "no-array-constructor": 2,
+    "no-bitwise": 0,
+    "no-caller": 2,
+    "no-catch-shadow": 2,
+    "comma-dangle": 2,
+    "no-console": 0,
+    "no-control-regex": 2,
+    "no-debugger": 2,
+    "no-delete-var": 2,
+    "no-div-regex": 2,
+    "no-dupe-keys": 2,
+    "no-else-return": 0,
+    "no-empty": 2,
+    "no-empty-character-class": 2,
+    "no-empty-label": 2,
+    "no-eq-null": 0,
+    "no-eval": 2,
+    "no-ex-assign": 2,
+    "no-fallthrough": 2,
+    "no-floating-decimal": 2,
+    "no-func-assign": 2,
+    "no-global-strict": 0,
+    "no-implied-eval": 2,
+    "no-iterator": 2,
+    "no-label-var": 2,
+    "no-loop-func": 0,
+    "no-mixed-requires": [0, false],
+    "no-multi-str": 2,
+    "no-native-reassign": 2,
+    "no-new": 0,
+    "no-new-func": 2,
+    "no-new-object": 2,
+    "no-new-wrappers": 2,
+    "no-obj-calls": 2,
+    "no-octal": 2,
+    "no-octal-escape": 2,
+    "no-plusplus": 0,
+    "no-proto": 2,
+    "no-redeclare": 2,
+    "no-regex-spaces": 2,
+    "no-return-assign": 0,
+    "no-script-url": 2,
+    "no-self-compare": 2,
+    "no-sequences": 0,
+    "no-shadow": 0,
+    "no-sync": 0,
+    "no-ternary": 0,
+    "no-trailing-spaces": 0,
+    "no-undef": 0,
+    "no-undef-init": 2,
+    "no-underscore-dangle": 0,
+    "no-unreachable": 2,
+    "no-unused-expressions": 0,
+    "no-unused-vars": 0,
+    "no-use-before-define": 0,
+    "no-with": 2,
+    "no-extra-parens": 2,
+    "no-yoda": 0,
+    "block-scoped-var": 0,
+    "brace-style": 0,
+    "camelcase": 0,
+    "complexity": [0, 11],
+    "consistent-return": 0,
+    "consistent-this": [0, "that"],
+    "curly": 0,
+    "dot-notation": 0,
+    "eqeqeq": 2,
+    "guard-for-in": 0,
+    "max-depth": [0, 4],
+    "max-len": [0, 80, 4],
+    "max-params": [0, 3],
+    "max-statements": [0, 10],
+    "new-cap": 0,
+    "new-parens": 2,
+    "one-var": 0,
+    "quote-props": 0,
+    "quotes": [0, "single"],
+    "radix": 0,
+    "semi": 0,
+    "strict": 0,
+    "unnecessary-strict": 0,
+    "use-isnan": 2,
+    "valid-jsdoc": 2,
+    "wrap-iife": 0,
+    "wrap-regex": 0,
+    "yoda": 0
+  }
+}

.istanbul.yml

@@ -0,0 +1,49 @@
+verbose: false
+instrumentation:
+    root: .
+    default-excludes: true
+    excludes: []
+    embed-source: false
+    variable: __coverage__
+    compact: true
+    preserve-comments: false
+    complete-copy: false
+    save-baseline: false
+    baseline-file: ./coverage/coverage-baseline.json
+    include-all-sources: false
+reporting:
+    print: summary
+    reports:
+        - lcov
+    dir: ./coverage
+    watermarks:
+        statements: [50, 80]
+        lines: [50, 80]
+        functions: [50, 80]
+        branches: [50, 80]
+    report-config:
+        clover: {file: clover.xml}
+        cobertura: {file: cobertura-coverage.xml}
+        json: {file: coverage-final.json}
+        json-summary: {file: coverage-summary.json}
+        lcovonly: {file: lcov.info}
+        teamcity: {file: null}
+        text: {file: null, maxCols: 0}
+        text-summary: {file: null}
+hooks:
+    hook-run-in-context: false
+    post-require-hook: null
+    handle-sigint: false
+check:
+    global:
+        statements: 0
+        lines: 0
+        branches: 0
+        functions: 0
+        excludes: []
+    each:
+        statements: 0
+        lines: 0
+        branches: 0
+        functions: 0
+        excludes: []

.npmignore

@@ -0,0 +1,8 @@
+.eslintrc
+.idea
+.npmrc
+gulpfile.js
+node_modules
+npm-debug.log
+tests
+NOTES.md

.travis.yml

@@ -0,0 +1,8 @@
+language: node_js
+node_js:
+  - 0.10
+  - 0.12
+  - iojs
+before_script:
+  - npm install -g gulp
+script: gulp

CHANGELOG.md

@@ -0,0 +1,4 @@
+# Change Log
+
+## 1.0.0
+* Initial release.

CONTRIBUTING.md

@@ -0,0 +1,22 @@
+# Contributing
+
+To contribute:
+
+* Install the [Gulp](http://gulpjs.com/) task runner.
+* Create a feature or bugfix branch of master.
+* Clone your branch.
+* Run `$ node install` from the project's root folder.
+
+Contributions are welcome as long provided the follow the guidelines outlined below.  Failure to satisfy all guidelines will result in rejection.
+
+* All modifications must be made via pull request.
+
+* This library is designed to be a drop-in replacement for the Couchnode module.  All functionality must be non-breaking extensions of the base Couchnode module.
+
+* All updates must update the version number according to the [semver](http://semver.org/) guideline.
+
+* All updates must include a description of the changes in the [Change Log](CHANGELOG.md).
+
+* All changes to the core module code must include proper test coverage.  Tests must reach 100% code coverage.
+
+* All commits to master must result in a successful build and test run.

README.md

@@ -1,2 +1,48 @@
-# couchbase-promises
-A lightweight A+ Promises wrapper for the Couchbase SDK.
+# Couchbase Promises
+A lightweight, drop-in replacement for the Couchnode module with added support for A+ Promises.
+
+[![Build Status](https://secure.travis-ci.org/dsfields/couchbase-promises.svg)](https://travis-ci.org/dsfields/couchbase-promises)
+
+## Overview
+Just like the [Couchbase Node.js module](http://developer.couchbase.com/documentation/server/4.0/sdks/node-2.0/introduction.html), 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](http://bluebirdjs.com/docs/getting-started.html) 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...
+
+```js
+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;
+      });
+  }
+};
+```

gulpfile.js

@@ -0,0 +1,25 @@
+var gulp = require('gulp');
+var eslint = require('gulp-eslint');
+var istanbul = require('gulp-istanbul');
+var jsvalidate = require('gulp-jsvalidate')
+var mocha = require('gulp-mocha');
+
+gulp.task('lint', function() {
+  return gulp.src(['./**/*.js', '!./node_modules/**', '!./coverage/**'])
+    .pipe(eslint())
+    .pipe(eslint.format());
+});
+
+gulp.task('test', function() {
+  return gulp.src('tests/unit/**/*.js')
+    .pipe(mocha({ reporter: 'spec' }))
+    .pipe(istanbul.writeReports())
+    .pipe(istanbul.enforceThresholds({ thresholds: { global: 90 } }));
+});
+
+gulp.task('jsvalidate', function() {
+  return gulp.src('**/*.js')
+    .pipe(jsvalidate());
+});
+
+gulp.task('default', ['lint', 'test']);