Add Google SingIn & email data user identification support.

Author: kmagiera

CosmoseSDK/Headers/CosmoseSDK.h

@@ -8,7 +8,7 @@
 
 #import <Foundation/Foundation.h>
 
-@class FBSession;
+@class FBSession, GPPSignIn;
 
 /**
  `CosmoseSDK` is a main entry class of Cosmose SDK library.
@@ -58,7 +58,51 @@
  Either way it is possible to provide `FBSession` instance by directly calling `[FBSession activeSession]` from the app's login flow.
  
  @param fbSession The instance of active and open Facebook session obtained via Facebook-iOS-SDK (see https://developers.facebook.com/docs/ios )
+ 
+ @see updateFbDataWithToken:userInfo:
  */
 + (void)updateFbSession:(FBSession*)fbSession;
 
+/**
+ Alternative way to update facebook related user details. Use this method instead of `updateFbSession:`) when your app doesn't utilize Facebook SDK or when incompatible version of SDK is in use.
+ `Nil` value can be provided for each of two parameters if not available at the moment of call and can be provided later.
+ 
+ @param fbToken Facebook API token (if available)
+ @param fbUserInfo Dictionary with user data including user fbid (if available)
+ 
+ @see updateFbSession:
+ */
++ (void)updateFbDataWithToken:(NSString*)fbToken userInfo:(NSDictionary*)fbUserInfo;
+
+/**
+ Link user's google account to Cosmose SDK user database.
+ If your app supports Google SignIn via Google Plus SDK use this method to provide basic user data to Cosmose SDK.
+ This method should be called as soon as the sing in (or silent sign in) is completed. The best place to put call to this method is in `GPPSignInDelegate`'s method `finishedWithAuth:error:` when error is not `nil.
+ To retrieve handle to active `GPPSignIn` instance you may call `[GPPSignIn sharedInstance]`
+ 
+ @param googleSignIn The active instance of `GPPSignIn` interface
+ 
+ @see updateGoogleSignInDataWithEmail:userID:
+ */
++ (void)updateGoogleSignIn:(GPPSignIn*)googleSignIn;
+
+/**
+ Alternative way to provide basic user data info in case when app supports Google Sign In. You should use this method instead of `updateGoogleSignIn:` when `GPPSignIn` inteface is not available in your app.
+ 
+ @param googleUserEmail User's email address used for Google Sign In
+ @param googleUserID User's google ID retireved after successfull sing in
+ 
+ @see updateGoogleSignIn:
+ */
++ (void)updateGoogleSignInDataWithEmail:(NSString*)googleUserEmail userID:(NSString*)googleUserID;
+
+/**
+ If your app support user login via e-mail and no Facebook nor Google authentication is in use, you may call this method to link basic user's info with Cosmose SDK.
+ 
+ @param userEmail User's email address used for app sign in or retireved from user at any point during the app usage
+ 
+ @see updateGoogleSignIn: updateFbSession:
+ */
++ (void)updateUserEmail:(NSString*)userEmail;
+
 @end

CosmoseSDK/libCosmoseSDK.a

@@ -59,6 +59,15 @@ We assume here, that your app integrating Facebook Login is based on a official
 
 1. After the successfull login or once the app detect that user is already logged in call: `[CosmoseSDK updateFbSession:]`, and pass an instance of `FBSession` that represents the active session (e.g., `[FBSession activeSession]`).
 
+Please refer to `[CosmoseSDK updateFbDataWithToken:userInfo:]` method (more info in the `appledoc`) if your app is based on incompatible version of Facebook SDK or your app is not based on Facebook SDK at all but still supports Facebook Sign In.
+
+## Google SignIn integration
+
+If your app supports Google SignIn, you may use `[CosmoseSDK updateGoogleSignIn:]` method to provide basic user data to Cosmose SDK. If ths sign-in process is compatible with the instructions from here: https://developers.google.com/+/mobile/ios/sign-in then you may add a call to `[CosmoseSDK updateGoogleSignIn:]` directly to your apps' `GPPSignInDelegate`. Otherwise please refer to Cosmose SDK `appledoc` and method `[CosmoseSDK updateGoogleSignInDataWithEmail:userID]` in order to pass basic user info to Cosmose SDK.
+
+## Alternative user identification methods
+
+If your app does not incorporate Facebook or Google Sign In but still requires user to type in his or her email address (for alternative sign in process or regardless of the reason) you may provide that information to Cosmose SDK. Once user type in a email address within your app you should call `[CosmoseSDK updateUserEmail:]` passing that email address. Please refer to the `appledoc` for more information about this method.
 
 # Demo App