Add customer.list function

README.md

@@ -27,14 +27,15 @@ Access to the [Stripe](https://stripe.com/) [API](http://stripe.com/api).
 
 ## API
 
-All methods takes a callback as their last parameter. The callback is called with an error code (if any) and then
-the response.
+All methods takes a callback as their last parameter. The callback is
+called with an error code (if any) and then the response.
 
 * `stripe.customers` - create, retrieve, update and delete customers
    * `.create(customer)` - create a customer, takes the data as an object
-   * `.retrieve(customer_id)` - retrieve a customer by customer id
+   * `.retrieve(customer_id)` - retrieve a customer by customer id.
    * `.update(customer_id, updates)` - update a customer; `updates` is an object with new parameters
    * `.del(customer_id)` - mark the customer deleted
+   * `.list(count, offset)` - [List customers](https://stripe.com/api/docs#list_customers)
 * `stripe.tokens` - [Tokens API](https://stripe.com/api/docs#tokens)
    * `.create(card_data)` - [create a token](https://stripe.com/api/docs#create_token)
    * `.retrieve(token_id)` - [retrieve a card token](https://stripe.com/api/docs#retrieve_token)

lib/main.js

@@ -95,13 +95,19 @@ module.exports = function (api_key, options) {
                 post("/v1/customers", data, cb);
             },
             retrieve: function(customer_id, cb) {
+                if (!(customer_id && typeof customer_id === 'string')) {
+                    cb("customer_id required");
+                }
                 get("/v1/customers/" + customer_id, {}, cb);
             },
             update: function(customer_id, data, cb) {
                 post("/v1/customers/" + customer_id, data, cb);
             },
             del: function(customer_id, cb) {
                 del("/v1/customers/" + customer_id, {}, cb);
+            },
+            list: function(count, offset, cb) {
+                get("/v1/customers", { count: count, offset: offset}, cb );
             }
         },
         token: {

test/customers.js

@@ -13,7 +13,7 @@ var stripe = require('./../lib/main.js')(api_key);
 
 vows.describe("Customer API").addBatch({
    'Create customer' : {
-        topic: function() { 
+        topic: function() {
            stripe.customers.create({email: "foo@example.com"}, this.callback);
         },
         'returns a customer': function(err, response) {
@@ -61,4 +61,12 @@ vows.describe("Customer API").addBatch({
             },
         },
    },
+   'Customer list' : {
+       topic: function() {
+           stripe.customers.list(5, 0, this.callback);
+       },
+       'Got count': function(err, response) {
+           assert.isNumber(response.count);
+       },
+   }
 }).export(module, {error: false});