Added support for storing tokens in localStorage with PhoneGap.

Author: Timothy E. Johansson

README.md

@@ -244,7 +244,6 @@ user.onAuthenticationRequired(function(toState, toParams) {
 ```
 For the Angular router the target route is passed to the handler. For the UI router, the target state and the target state parameters are passed.
 
-
 To add required permissions to a route, use the `hasPermission` property and specify all the permissions as an array, like this:
 
 ```javascript
@@ -278,6 +277,17 @@ user.onAccessDenied(function(user, state, params) {
 
 For the Angular router the target route is passed as second parameter to the handler. For the UI router, the target state and the target state parameters are passed as parameters two and three.
 
+After a successful login, the default behaviour is to transition to the default route. To change this behaviour, override the `authenticationSuccessHandler` and return false to abort the transition. Override the default `authenticationSuccessHandler` like this:
+
+```javascript
+user.onAuthenticationSuccess(function() {
+    // hide popup, do transition, ...
+
+    // return true to transition to the default route.
+    // return false to do nothing.
+    return false;
+});
+```
 
 ## Loaders
 

angularjs.userapp.js

@@ -8,6 +8,22 @@ var userappModule = angular.module('UserApp', []);
     // Expose the UserApp API
     userappModule.value('UserApp', UserApp);
 
+    /**
+     * Token storage, default is in a cookie. The PhoneGap integration will override this
+     * to store the token in localStorage instead.
+     */
+    UserApp.tokenStorage || (UserApp.tokenStorage = {
+        get: function() {
+            return Cookies.get('ua_session_token');
+        },
+        set: function(token) {
+            Cookies.set('ua_session_token', token, { expires: new Date(new Date().getTime() + 31536000000) });
+        },
+        remove: function() {
+            Cookies.expire('ua_session_token');
+        }
+    });
+
     // Directive error handler
     var handleError = function(scope, error, elementId) {
         if (!error) {
@@ -34,7 +50,7 @@ var userappModule = angular.module('UserApp', []);
         var user = {};
         var appId = null;
         var options = null;
-        var token = Cookies.get('ua_session_token');
+        var token = UserApp.tokenStorage.get();
         var status = { authorized: false, authenticated: false };
         var heartBeatInterval = -1;
         var defaultRoute = null;
@@ -305,7 +321,7 @@ var userappModule = angular.module('UserApp', []);
                 status.authenticated = false;
 
                 // Remove session cookie
-                Cookies.expire('ua_session_token');
+                UserApp.tokenStorage.remove();
 
                 for (var key in user) {
                     delete user[key];
@@ -341,7 +357,7 @@ var userappModule = angular.module('UserApp', []);
                     $rootScope.user.authenticated = true;
 
                     // Set session cookie
-                    Cookies.set('ua_session_token', token, { expires: new Date(new Date().getTime() + 31536000000) });
+                    UserApp.tokenStorage.set(token);
                 }
 
                 return token;

bower.json

@@ -1,7 +1,7 @@
 {
-        "name": "userapp-angular",
-        "version": "1.6.2",
-        "main": "./angularjs.userapp.js",
+	"name": "userapp-angular",
+	"version": "1.7.0",
+	"main": "./angularjs.userapp.js",
 	"dependencies": {
 		"userapp": "latest"
 	}