feat(articles): Article Admin feature (#807)

This feature introduces a breaking change, that restricts the User's that
can create/edit/delete Articles to only those that have the `admin` Role.

Fixed ESLint issues.

Resolved merge conflicts, and moved new client Article Service
`createOrUpdate` functionality to new Admin feature controller.

Removed edit functionality from client-side Article controller.

modules/articles/tests/client/admin.articles.client.controller.tests.js

@@ -0,0 +1,168 @@
+(function () {
+  'use strict';
+
+  describe('Articles Controller Tests', function () {
+    // Initialize global variables
+    var ArticlesController,
+      $scope,
+      $httpBackend,
+      $state,
+      Authentication,
+      ArticlesService,
+      mockArticle;
+
+    // The $resource service augments the response object with methods for updating and deleting the resource.
+    // If we were to use the standard toEqual matcher, our tests would fail because the test values would not match
+    // the responses exactly. To solve the problem, we define a new toEqualData Jasmine matcher.
+    // When the toEqualData matcher compares two objects, it takes only object properties into
+    // account and ignores methods.
+    beforeEach(function () {
+      jasmine.addMatchers({
+        toEqualData: function (util, customEqualityTesters) {
+          return {
+            compare: function (actual, expected) {
+              return {
+                pass: angular.equals(actual, expected)
+              };
+            }
+          };
+        }
+      });
+    });
+
+    // Then we can start by loading the main application module
+    beforeEach(module(ApplicationConfiguration.applicationModuleName));
+
+    // The injector ignores leading and trailing underscores here (i.e. _$httpBackend_).
+    // This allows us to inject a service but then attach it to a variable
+    // with the same name as the service.
+    beforeEach(inject(function ($controller, $rootScope, _$state_, _$httpBackend_, _Authentication_, _ArticlesService_) {
+      // Set a new global scope
+      $scope = $rootScope.$new();
+
+      // Point global variables to injected services
+      $httpBackend = _$httpBackend_;
+      $state = _$state_;
+      Authentication = _Authentication_;
+      ArticlesService = _ArticlesService_;
+
+      // create mock article
+      mockArticle = new ArticlesService({
+        _id: '525a8422f6d0f87f0e407a33',
+        title: 'An Article about MEAN',
+        content: 'MEAN rocks!'
+      });
+
+      // Mock logged in user
+      Authentication.user = {
+        roles: ['user']
+      };
+
+      // Initialize the Articles controller.
+      ArticlesController = $controller('ArticlesController as vm', {
+        $scope: $scope,
+        articleResolve: {}
+      });
+
+      // Spy on state go
+      spyOn($state, 'go');
+    }));
+
+    describe('vm.save() as create', function () {
+      var sampleArticlePostData;
+
+      beforeEach(function () {
+        // Create a sample article object
+        sampleArticlePostData = new ArticlesService({
+          title: 'An Article about MEAN',
+          content: 'MEAN rocks!'
+        });
+
+        $scope.vm.article = sampleArticlePostData;
+      });
+
+      it('should send a POST request with the form input values and then locate to new object URL', inject(function (ArticlesService) {
+        // Set POST response
+        $httpBackend.expectPOST('api/articles', sampleArticlePostData).respond(mockArticle);
+
+        // Run controller functionality
+        $scope.vm.save(true);
+        $httpBackend.flush();
+
+        // Test URL redirection after the article was created
+        expect($state.go).toHaveBeenCalledWith('admin.articles.list');
+      }));
+
+      it('should set $scope.vm.error if error', function () {
+        var errorMessage = 'this is an error message';
+        $httpBackend.expectPOST('api/articles', sampleArticlePostData).respond(400, {
+          message: errorMessage
+        });
+
+        $scope.vm.save(true);
+        $httpBackend.flush();
+
+        expect($scope.vm.error).toBe(errorMessage);
+      });
+    });
+
+    describe('vm.save() as update', function () {
+      beforeEach(function () {
+        // Mock article in $scope
+        $scope.vm.article = mockArticle;
+      });
+
+      it('should update a valid article', inject(function (ArticlesService) {
+        // Set PUT response
+        $httpBackend.expectPUT(/api\/articles\/([0-9a-fA-F]{24})$/).respond();
+
+        // Run controller functionality
+        $scope.vm.save(true);
+        $httpBackend.flush();
+
+        // Test URL location to new object
+        expect($state.go).toHaveBeenCalledWith('admin.articles.list');
+      }));
+
+      it('should set $scope.vm.error if error', inject(function (ArticlesService) {
+        var errorMessage = 'error';
+        $httpBackend.expectPUT(/api\/articles\/([0-9a-fA-F]{24})$/).respond(400, {
+          message: errorMessage
+        });
+
+        $scope.vm.save(true);
+        $httpBackend.flush();
+
+        expect($scope.vm.error).toBe(errorMessage);
+      }));
+    });
+
+    describe('vm.remove()', function () {
+      beforeEach(function () {
+        // Setup articles
+        $scope.vm.article = mockArticle;
+      });
+
+      it('should delete the article and redirect to articles', function () {
+        // Return true on confirm message
+        spyOn(window, 'confirm').and.returnValue(true);
+
+        $httpBackend.expectDELETE(/api\/articles\/([0-9a-fA-F]{24})$/).respond(204);
+
+        $scope.vm.remove();
+        $httpBackend.flush();
+
+        expect($state.go).toHaveBeenCalledWith('admin.articles.list');
+      });
+
+      it('should should not delete the article and not redirect', function () {
+        // Return false on confirm message
+        spyOn(window, 'confirm').and.returnValue(false);
+
+        $scope.vm.remove();
+
+        expect($state.go).not.toHaveBeenCalled();
+      });
+    });
+  });
+}());