[api] Add AccessScope resource

Fixes: #170

README.md

@@ -152,6 +152,8 @@ shopify.metafield.create({
 
 ### Available resources and methods
 
+- accessScope
+  - `list()`
 - apiPermission
   - `delete()`
 - applicationCharge

index.d.ts

@@ -27,8 +27,11 @@ type onCallLimitsFn = (limits: Shopify.ICallLimits) => void;
 declare class Shopify {
     constructor(config: Shopify.IPublicShopifyConfig | Shopify.IPrivateShopifyConfig);
     callLimits: Shopify.ICallLimits;
+    accessScope: {
+        list: () => Promise<Shopify.IAccessScope[]>
+    };
     apiPermission: {
-        delete(): void;
+        delete: () => Promise<void>;
     };
     // abandonedCheckouts
     applicationCharge: {
@@ -428,6 +431,10 @@ declare namespace Shopify {
         max: number;
     }
 
+    interface IAccessScope {
+        handle: string
+    }
+
     interface ICheckout {
         abandoned_checkout_url: string;
         applied_discount?: ICheckoutDiscount[];

resources/access-scope.js

@@ -0,0 +1,30 @@
+'use strict';
+
+const assign = require('lodash/assign');
+
+/**
+ * Creates an AccessScope instance.
+ *
+ * @param {Shopify} shopify Reference to the Shopify instance
+ * @constructor
+ * @public
+ */
+function AccessScope(shopify) {
+  this.shopify = shopify;
+
+  this.name = 'access_scopes';
+}
+
+/**
+ * Retrieves a list of access scopes associated to the access token.
+ *
+ * @return {Promise} Promise that resolves with the result
+ * @public
+ */
+AccessScope.prototype.list = function list() {
+  const path = `/admin/oauth/${this.name}.json`;
+  const url = assign({ path }, this.shopify.baseUrl);
+  return this.shopify.request(url, 'GET', this.name);
+};
+
+module.exports = AccessScope;

test/access-scope.test.js

@@ -0,0 +1,24 @@
+describe('Shopify#accessScope', () => {
+  'use strict';
+
+  const expect = require('chai').expect;
+
+  const fixtures = require('./fixtures/access-scope');
+  const common = require('./common');
+
+  const shopify = common.shopify;
+  const scope = common.scope;
+
+  afterEach(() => expect(scope.isDone()).to.be.true);
+
+  it('gets a list of access scopes associated to the access token', () => {
+    const output = fixtures.res.list;
+
+    scope
+      .get('/admin/oauth/access_scopes.json')
+      .reply(200, output);
+
+    return shopify.accessScope.list()
+      .then(data => expect(data).to.deep.equal(output.access_scopes));
+  });
+});

test/fixtures/access-scope/index.js

@@ -0,0 +1,3 @@
+'use strict';
+
+exports.res = require('./res');

test/fixtures/access-scope/res/index.js

@@ -0,0 +1,3 @@
+'use strict';
+
+exports.list = require('./list');

test/fixtures/access-scope/res/list.json

@@ -0,0 +1,13 @@
+{
+  "access_scopes": [
+    {
+      "handle": "read_products"
+    },
+    {
+      "handle": "write_orders"
+    },
+    {
+      "handle": "read_orders"
+    }
+  ]
+}