Initial commit

Author: Juan Rossi

Readme.md

@@ -0,0 +1,65 @@
+## Usage
+
+### Import the library and set your secret API key:
+```
+var mango = require('mango')({ 'api_key': 'your Mango secret API key'});
+```
+
+### Create a charge
+In order to create a Charge, you must call the `create()` method with [the required arguments](https://developers.getmango.com/en/api/charges/?platform=node#arguments).
+
+```
+mango.Charges.create({
+  'token': 'token_mwhushs06o62aruq9n3pmvu7f0ia696y',
+  'amount': 2000,
+  'email': '[email protected]'
+}, function(err, charge) {
+  console.log(charge);
+});
+```
+
+### Get single charge
+When you have a charge `uid`, you can get a full detail using the `get()` method:
+```
+mango.Charges.get('charge_1234123141231', function(err, charge) {
+  console.log(charge);
+});
+```
+
+You can also work with all the other resources authenticated with a secret API Key:
+- [Charges](https://developers.getmango.com/en/api/charges/?platform=node)
+- [Refunds](https://developers.getmango.com/en/api/refunds/?platform=node)
+- [Customers](https://developers.getmango.com/en/api/customers/?platform=node)
+- [Cards](https://developers.getmango.com/en/api/cards/?platform=node)
+- [Queue](https://developers.getmango.com/en/api/queue/?platform=node)
+- [Installments](https://developers.getmango.com/en/api/installments/?platform=node)
+
+## Tests
+
+Install the module along with the dev dependencies.
+```
+$ git clone git://github.com/mango/mango-node.git
+$ cd mango-node
+$ npm install
+```
+
+To run the tests you'll need Mango API keys (mode Sandbox):
+```
+export MANGO_SECRET_TEST_KEY='your secret test API key'
+export MANGO_PUBLIC_TEST_KEY='your public test API Key'
+```
+
+### Run the tests
+```
+$ npm test
+```
+
+### Run code coverage
+```
+$ npm run coverage
+```
+
+## Liecense
+Licensed under the MIT license.
+
+Copyright (c) 2014 Mango.

examples/list_charges.js

@@ -0,0 +1,17 @@
+
+/**
+ * Module dependencies
+ */
+
+var mango = require('../')({ 'api_key': process.env.MANGO_SECRET_TEST_KEY });
+
+/**
+ * List charges
+ */
+mango.Charges.list(function(err, charges){
+  if(err) {
+    console.error(err); // Handle error
+  } else {
+    console.log(charges); // Response
+  }
+});

lib/index.js

@@ -0,0 +1,53 @@
+'use strict';
+
+/**
+ * Module dependencies
+ */
+
+var debug = require('debug')('mango:api');
+
+/**
+ * Resources
+ */
+
+var Customers = require('./resources/customers');
+var Cards = require('./resources/cards');
+var Charges = require('./resources/charges');
+var Refunds = require('./resources/refunds');
+var Queue = require('./resources/queue');
+var Installments = require('./resources/installments');
+
+/**
+ * Expose constructor
+ */
+
+module.exports = Mango;
+
+/**
+ * Mango constructor
+ *
+ * @param {String} api_key
+ * @return {Mango} API client instance
+ * @api public
+ */
+
+function Mango(options) {
+  if(!(this instanceof Mango)) {
+    return new Mango(options);
+  }
+
+  /* istanbul ignore next */
+  if('string' != typeof options.api_key) {
+    throw new Error('Please provide a valid api_key');
+  }
+
+  this._api_key = options.api_key;
+  this.Customers = new Customers(this);
+  this.Cards = new Cards(this);
+  this.Charges = new Charges(this);
+  this.Refunds = new Refunds(this);
+  this.Queue = new Queue(this);
+  this.Installments = new Installments(this);
+
+  debug('Client intialized');
+}

lib/resources/cards.js

@@ -0,0 +1,84 @@
+
+/**
+ * Module dependencies
+ */
+
+var util = require('util');
+var Resource = require('./');
+
+/**
+ * Expose constructor
+ */
+
+module.exports = Cards;
+
+/**
+ * Cards constructor
+ */
+
+function Cards(mango) {
+  Resource.call(this, mango);
+}
+
+util.inherits(Cards, Resource);
+
+/**
+ * Get card
+ *
+ * @param {String} uid
+ * @param {Function} callback
+ * @api public
+ */
+
+Cards.prototype.get = function(uid, fn) {
+  return this.request('get', '/cards/' + uid + '/', fn);
+};
+
+/**
+ * List cards
+ *
+ * @param {Object} options
+ * @param {Function} callback
+ * @api public
+ */
+
+Cards.prototype.list = function(options, fn) {
+  return this.request('get', '/cards/', options, fn);
+};
+
+/**
+ * Create card
+ *
+ * @param {Object} options
+ * @param {Function} callback
+ * @api public
+ */
+
+Cards.prototype.create = function(options, fn) {
+  return this.request('post', '/cards/', options, fn);
+};
+
+/**
+ * Update card
+ *
+ * @param {string} uid
+ * @param {object} options
+ * @param {function} callback
+ * @api public
+ */
+
+Cards.prototype.update = function(uid, options, fn) {
+  return this.request('patch', '/cards/' + uid + '/', options, fn);
+};
+
+/**
+ * Delete card
+ *
+ * @param {string} uid
+ * @param {function} callback
+ * @api public
+ */
+
+Cards.prototype.del = function(uid, fn) {
+  return this.request('delete', '/cards/' + uid + '/', fn);
+};

lib/resources/charges.js

@@ -0,0 +1,59 @@
+
+/**
+ * Module dependencies
+ */
+
+var util = require('util');
+var Resource = require('./');
+
+/**
+ * Expose constructor
+ */
+
+module.exports = Charges;
+
+/**
+ * Charges constructor
+ */
+
+function Charges(mango) {
+  Resource.call(this, mango);
+}
+
+util.inherits(Charges, Resource);
+
+/**
+ * Get charge
+ *
+ * @param {String} uid
+ * @param {Function} callback
+ * @api public
+ */
+
+Charges.prototype.get = function(uid, fn) {
+  return this.request('get', '/charges/' + uid + '/', fn);
+};
+
+/**
+ * List charges
+ *
+ * @param {Object} options
+ * @param {Function} callback
+ * @api public
+ */
+
+Charges.prototype.list = function(options, fn) {
+  return this.request('get', '/charges/', options, fn);
+};
+
+/**
+ * Create charge
+ *
+ * @param {Object} options
+ * @param {Function} callback
+ * @api public
+ */
+
+Charges.prototype.create = function(options, fn) {
+  return this.request('post', '/charges/', options, fn);
+};

lib/resources/customers.js

@@ -0,0 +1,84 @@
+
+/**
+ * Module dependencies
+ */
+
+var util = require('util');
+var Resource = require('./');
+
+/**
+ * Expose constructor
+ */
+
+module.exports = Customers;
+
+/**
+ * Customers constructor
+ */
+
+function Customers(mango) {
+  Resource.call(this, mango);
+}
+
+util.inherits(Customers, Resource);
+
+/**
+ * Get customer
+ *
+ * @param {String} uid
+ * @param {Function} callback
+ * @api public
+ */
+
+Customers.prototype.get = function(uid, fn) {
+  return this.request('get', '/customers/' + uid + '/', fn);
+};
+
+/**
+ * List customers
+ *
+ * @param {Object} options
+ * @param {Function} callback
+ * @api public
+ */
+
+Customers.prototype.list = function(options, fn) {
+  return this.request('get', '/customers/', options, fn);
+};
+
+/**
+ * Create customer
+ *
+ * @param {Object} options
+ * @param {Function} callback
+ * @api public
+ */
+
+Customers.prototype.create = function(options, fn) {
+  return this.request('post', '/customers/', options, fn);
+};
+
+/**
+ * Update customer
+ *
+ * @param {string} uid
+ * @param {object} options
+ * @param {function} callback
+ * @api public
+ */
+
+Customers.prototype.update = function(uid, options, fn) {
+  return this.request('patch', '/customers/' + uid + '/', options, fn);
+};
+
+/**
+ * Delete customer
+ *
+ * @param {string} uid
+ * @param {function} callback
+ * @api public
+ */
+
+Customers.prototype.del = function(uid, fn) {
+  return this.request('delete', '/customers/' + uid + '/', fn);
+};