feat(app): implement util module for thin, reusable functions

Author: kingcody

Diff for: app/templates/client/components/auth(auth)/auth.module(js).js

@@ -2,6 +2,7 @@
 
 angular.module('<%= scriptAppName %>.auth', [
   '<%= scriptAppName %>.constants',
+  '<%= scriptAppName %>.util',
   'ngCookies'<% if (filters.ngroute) { %>,
   'ngRoute'<% } if (filters.uirouter) { %>,
   'ui.router'<% } %>

Diff for: app/templates/client/components/auth(auth)/auth.service(js).js

@@ -2,19 +2,10 @@
 
 (function() {
 
-function AuthService($location, $http, $cookies, $q, appConfig, User) {
-  /**
-   * Return a callback or noop function
-   *
-   * @param  {Function|*} cb - a 'potential' function
-   * @return {Function}
-   */
-  var safeCb = function(cb) {
-    return (angular.isFunction(cb)) ? cb : angular.noop;
-  },
-
-  currentUser = {},
-  userRoles = appConfig.userRoles || [];
+function AuthService($location, $http, $cookies, $q, appConfig, Util, User) {
+  var safeCb = Util.safeCb;
+  var currentUser = {};
+  var userRoles = appConfig.userRoles || [];
 
   if ($cookies.get('token') && $location.path() !== '/logout') {
     currentUser = User.get();

Diff for: app/templates/client/components/util/util.module.js

@@ -0,0 +1,3 @@
+'use strict';
+
+angular.module('<%= scriptAppName %>.util', []);

Diff for: app/templates/client/components/util/util.service.js

@@ -0,0 +1,62 @@
+'use strict';
+
+(function() {
+
+/**
+ * The Util service is for thin, globally reusable, utility functions
+ */
+function UtilService($window) {
+
+  var Util = {
+
+    /**
+     * Return a callback or noop function
+     *
+     * @param  {Function|*} cb - a 'potential' function
+     * @return {Function}
+     */
+    safeCb: function(cb) {
+      return (angular.isFunction(cb)) ? cb : angular.noop;
+    },
+
+    /**
+     * Parse a given url with the use of an anchor element
+     *
+     * @param  {String} url - the url to parse
+     * @return {Object}     - the parsed url, anchor element
+     */
+    urlParse: function(url) {
+      var a = document.createElement('a');
+      a.href = url;
+      return a;
+    },
+
+    /**
+     * Test whether or not a given url is same origin
+     *
+     * @param  {String}           url       - url to test
+     * @param  {String|String[]}  [origins] - additional origins to test against
+     * @return {Boolean}                    - true if url is same origin
+     */
+    isSameOrigin: function(url, origins) {
+      url = Util.urlParse(url);
+      origins = (origins && [].concat(origins)) || [];
+      origins = origins.map(Util.urlParse);
+      origins.push($window.location);
+      origins = origins.filter(function(o) {
+        return url.hostname === o.hostname &&
+          url.port === o.port &&
+          url.protocol === o.protocol;
+      });
+      return (origins.length >= 1);
+    }
+
+  };
+
+  return Util;
+}
+
+angular.module('<%= scriptAppName %>.util')
+  .factory('Util', UtilService);
+
+})();

Diff for: test/test-file-creation.js

@@ -182,6 +182,8 @@ describe('angular-fullstack generator', function () {
       'client/components/navbar/navbar.' + markup,
       'client/components/navbar/navbar.controller.' + script,
       'client/components/navbar/navbar.directive.' + script,
+      'client/components/util/util.module.' + script,
+      'client/components/util/util.service.' + script,
       'server/.jshintrc',
       'server/.jshintrc-spec',
       'server/app.js',