Merge pull request #481 from stripe/jlomas-add-issuing-resources

Add Issuing API calls, create a 'StripeNamespace'

lib/ResourceNamespace.js

@@ -0,0 +1,22 @@
+'use strict';
+
+// ResourceNamespace allows you to create nested resources, i.e. `stripe.issuing.cards`.
+// It also works recursively, so you could do i.e. `stripe.billing.invoicing.pay`.
+
+function ResourceNamespace(stripe, resources) {
+  for (var name in resources) {
+    var camelCaseName = name[0].toLowerCase() + name.substring(1);
+
+    var resource = new resources[name](stripe);
+
+    this[camelCaseName] = resource;
+  }
+}
+
+module.exports = function(namespace, resources) {
+  return function (stripe) {
+    return new ResourceNamespace(stripe, resources);
+  };
+};
+
+module.exports.ResourceNamespace = ResourceNamespace;

lib/resources/Issuing/Authorizations.js

@@ -0,0 +1,22 @@
+'use strict';
+
+var StripeResource = require('../../StripeResource');
+var stripeMethod = StripeResource.method;
+
+module.exports = StripeResource.extend({
+  path: 'issuing/authorizations',
+
+  includeBasic: ['list', 'retrieve', 'update', 'setMetadata', 'getMetadata'],
+
+  approve: stripeMethod({
+    method: 'POST',
+    path: '/{id}/approve',
+    urlParams: ['id'],
+  }),
+
+  decline: stripeMethod({
+    method: 'POST',
+    path: '/{id}/decline',
+    urlParams: ['id'],
+  }),
+});

lib/resources/Issuing/Cardholders.js

@@ -0,0 +1,8 @@
+'use strict';
+
+var StripeResource = require('../../StripeResource');
+
+module.exports = StripeResource.extend({
+  path: 'issuing/cardholders',
+  includeBasic: ['create', 'list', 'retrieve', 'update', 'setMetadata', 'getMetadata'],
+});

lib/resources/Issuing/Cards.js

@@ -0,0 +1,16 @@
+'use strict';
+
+var StripeResource = require('../../StripeResource');
+var stripeMethod = StripeResource.method;
+
+module.exports = StripeResource.extend({
+  path: 'issuing/cards',
+
+  includeBasic: ['create', 'list', 'retrieve', 'update', 'setMetadata', 'getMetadata'],
+
+  retrieveDetails: stripeMethod({
+    method: 'GET',
+    path: '/{id}/details',
+    urlParams: ['id'],
+  }),
+});

lib/resources/Issuing/Disputes.js

@@ -0,0 +1,8 @@
+'use strict';
+
+var StripeResource = require('../../StripeResource');
+
+module.exports = StripeResource.extend({
+  path: 'issuing/disputes',
+  includeBasic: ['create', 'list', 'retrieve', 'update', 'setMetadata', 'getMetadata'],
+});

lib/resources/Issuing/Transactions.js

@@ -0,0 +1,8 @@
+'use strict';
+
+var StripeResource = require('../../StripeResource');
+
+module.exports = StripeResource.extend({
+  path: 'issuing/transactions',
+  includeBasic: ['list', 'retrieve', 'update', 'setMetadata', 'getMetadata'],
+});

lib/stripe.js

@@ -26,6 +26,8 @@ var APP_INFO_PROPERTIES = ['name', 'version', 'url'];
 var EventEmitter = require('events').EventEmitter;
 var exec = require('child_process').exec;
 
+var resourceNamespace = require('./ResourceNamespace');
+
 var resources = {
   // Support Accounts for consistency, Account for backwards compat
   Account: require('./resources/Accounts'),
@@ -73,6 +75,14 @@ var resources = {
   ApplicationFeeRefunds: require('./resources/ApplicationFeeRefunds'),
   TransferReversals: require('./resources/TransferReversals'),
 
+  // Namespaced resources
+  Issuing: resourceNamespace('issuing', {
+    Authorizations: require('./resources/Issuing/Authorizations'),
+    Cardholders: require('./resources/Issuing/Cardholders'),
+    Cards: require('./resources/Issuing/Cards'),
+    Transactions: require('./resources/Issuing/Transactions'),
+    Disputes: require('./resources/Issuing/Disputes'),
+  }),
 };
 
 Stripe.StripeResource = require('./StripeResource');

test/resources/Issuing/Authorization.spec.js

@@ -0,0 +1,78 @@
+'use strict';
+
+var stripe = require('../../testUtils').getSpyableStripe();
+var expect = require('chai').expect;
+
+describe('Issuing', function () {
+  describe('Authorization Resource', function() {
+    describe('retrieve', function() {
+      it('Sends the correct request', function() {
+        stripe.issuing.authorizations.retrieve('iauth_123');
+        expect(stripe.LAST_REQUEST).to.deep.equal({
+          method: 'GET',
+          url: '/v1/issuing/authorizations/iauth_123',
+          data: {},
+          headers: {},
+        });
+      });
+    });
+
+    describe('list', function() {
+      it('Sends the correct request', function() {
+        stripe.issuing.authorizations.list();
+        expect(stripe.LAST_REQUEST).to.deep.equal({
+          method: 'GET',
+          url: '/v1/issuing/authorizations',
+          data: {},
+          headers: {},
+        });
+      });
+    });
+
+    describe('update', function() {
+      it('Sends the correct request', function() {
+        stripe.issuing.authorizations.update('iauth_123', {
+          metadata: {
+            thing1: true,
+            thing2: 'yes'
+          },
+        });
+        expect(stripe.LAST_REQUEST).to.deep.equal({
+          method: 'POST',
+          url: '/v1/issuing/authorizations/iauth_123',
+          headers: {},
+          data: {
+            metadata: {
+              thing1: true,
+              thing2: 'yes'
+            },
+          },
+        });
+      });
+    });
+
+    describe('approve', function() {
+      it('Sends the correct request', function() {
+        stripe.issuing.authorizations.approve('iauth_123');
+        expect(stripe.LAST_REQUEST).to.deep.equal({
+          method: 'POST',
+          url: '/v1/issuing/authorizations/iauth_123/approve',
+          headers: {},
+          data: {},
+        });
+      });
+    });
+
+    describe('decline', function() {
+      it('Sends the correct request', function() {
+        stripe.issuing.authorizations.decline('iauth_123');
+        expect(stripe.LAST_REQUEST).to.deep.equal({
+          method: 'POST',
+          url: '/v1/issuing/authorizations/iauth_123/decline',
+          headers: {},
+          data: {},
+        });
+      });
+    });
+  });
+});

test/resources/Issuing/Cardholders.spec.js

@@ -0,0 +1,76 @@
+'use strict';
+
+var stripe = require('../../testUtils').getSpyableStripe();
+
+var expect = require('chai').expect;
+
+describe('Issuing', function () {
+  describe('Cardholders Resource', function () {
+    describe('retrieve', function () {
+      it('Sends the correct request', function () {
+        stripe.issuing.cardholders.retrieve('ich_123');
+
+        expect(stripe.LAST_REQUEST).to.deep.equal({
+          method: 'GET',
+          url: '/v1/issuing/cardholders/ich_123',
+          headers: {},
+          data: {},
+        });
+      });
+    });
+
+    describe('create', function () {
+      it('Sends the correct request', function () {
+        stripe.issuing.cardholders.create({
+          billing: {},
+          name: 'Tim Testperson',
+          type: 'individual',
+        });
+        expect(stripe.LAST_REQUEST).to.deep.equal({
+          method: 'POST',
+          url: '/v1/issuing/cardholders',
+          headers: {},
+          data: {
+            billing: {},
+            name: 'Tim Testperson',
+            type: 'individual',
+          },
+        });
+      });
+    });
+
+    describe('update', function () {
+      it('Sends the correct request', function () {
+        stripe.issuing.cardholders.update('ich_123', {
+          metadata: {
+            thing1: true,
+            thing2: 'yes'
+          },
+        });
+        expect(stripe.LAST_REQUEST).to.deep.equal({
+          method: 'POST',
+          url: '/v1/issuing/cardholders/ich_123',
+          headers: {},
+          data: {
+            metadata: {
+              thing1: true,
+              thing2: 'yes'
+            },
+          },
+        });
+      });
+    });
+
+    describe('list', function () {
+      it('Sends the correct request', function () {
+        stripe.issuing.cardholders.list();
+        expect(stripe.LAST_REQUEST).to.deep.equal({
+          method: 'GET',
+          url: '/v1/issuing/cardholders',
+          headers: {},
+          data: {},
+        });
+      });
+    });
+  });
+});

test/resources/Issuing/Cards.spec.js

@@ -0,0 +1,89 @@
+'use strict';
+
+var stripe = require('../../testUtils').getSpyableStripe();
+
+var expect = require('chai').expect;
+
+describe('Issuing', function () {
+  describe('Cards Resource', function () {
+    describe('retrieve', function () {
+      it('Sends the correct request', function () {
+        stripe.issuing.cards.retrieve('ic_123');
+
+        expect(stripe.LAST_REQUEST).to.deep.equal({
+          method: 'GET',
+          url: '/v1/issuing/cards/ic_123',
+          headers: {},
+          data: {},
+        });
+      });
+    });
+
+    describe('create', function () {
+      it('Sends the correct request', function () {
+        stripe.issuing.cards.create({
+          currency: 'usd',
+          type: 'physical',
+        });
+        expect(stripe.LAST_REQUEST).to.deep.equal({
+          method: 'POST',
+          url: '/v1/issuing/cards',
+          headers: {},
+          data: {
+            currency: 'usd',
+            type: 'physical',
+          },
+        });
+      });
+    });
+
+    describe('update', function () {
+      it('Sends the correct request', function () {
+        stripe.issuing.cards.update('ic_123', {
+          metadata: {
+            thing1: true,
+            thing2: 'yes'
+          },
+        });
+        expect(stripe.LAST_REQUEST).to.deep.equal({
+          method: 'POST',
+          url: '/v1/issuing/cards/ic_123',
+          headers: {},
+          data: {
+            metadata: {
+              thing1: true,
+              thing2: 'yes'
+            },
+          },
+        });
+      });
+    });
+
+    describe('list', function () {
+      it('Sends the correct request', function () {
+        stripe.issuing.cards.list();
+        expect(stripe.LAST_REQUEST).to.deep.equal({
+          method: 'GET',
+          url: '/v1/issuing/cards',
+          headers: {},
+          data: {},
+        });
+      });
+    });
+  });
+
+  describe('Virtual Cards Resource', function () {
+    describe('retrieve', function () {
+      it('Sends the correct request', function () {
+        stripe.issuing.cards.retrieveDetails('ic_123');
+
+        expect(stripe.LAST_REQUEST).to.deep.equal({
+          method: 'GET',
+          url: '/v1/issuing/cards/ic_123/details',
+          headers: {},
+          data: {},
+        });
+      });
+    });
+  });
+});