Add support for account linking

Author: kirre-bylund

Runtime/Client/LootLockerEndPoints.cs

@@ -31,6 +31,13 @@ public class LootLockerEndPoints
         public static EndPointClass whiteLabelRequestAccountVerification = new EndPointClass("white-label-login/request-verification", LootLockerHTTPMethod.POST);
         public static EndPointClass whiteLabelLoginSessionRequest = new EndPointClass("v2/session/white-label", LootLockerHTTPMethod.POST);
 
+        // Account Linking
+        [Header("Account Linking")]
+        public static EndPointClass StartAccountLinkingProcess = new EndPointClass("upa/link/start", LootLockerHTTPMethod.POST);
+        public static EndPointClass CheckStatusOfAccountLinkingProcess = new EndPointClass("upa/link/{0}", LootLockerHTTPMethod.GET);
+        public static EndPointClass CancelAccountLinkingProcess = new EndPointClass("upa/link/{0}", LootLockerHTTPMethod.DELETE);
+        public static EndPointClass UnlinkProviderFromAccount = new EndPointClass("player/providers/{0}", LootLockerHTTPMethod.DELETE);
+
         // Player
         [Header("Player")]
         public static EndPointClass getPlayerInfo = new EndPointClass("v1/player/info", LootLockerHTTPMethod.GET);

Runtime/Game/LootLockerSDKManager.cs

@@ -8,6 +8,10 @@
 using static LootLocker.LootLockerConfig;
 using System.Linq;
 using static LootLocker.Requests.CurrentPlatform;
+using static System.Net.WebRequestMethods;
+using static System.Runtime.CompilerServices.RuntimeHelpers;
+using System.Diagnostics;
+using File = System.IO.File;
 #if UNITY_EDITOR
 using UnityEditor;
 #endif
@@ -1061,6 +1065,90 @@ public static void WhiteLabelLoginAndStartSession(string email, string password,
 
         #endregion
 
+        #region Account Linking
+
+        /// <summary>
+        /// Start an account linking process on behalf of the currently signed in player
+        /// When you want to link an additional provider to a player, you start by initiating an account link.The player can then navigate to the online link flow using the code_page_url and code, or the qr_code and continue the linking process.
+        /// For the duration of the linking process you can check the status using the CheckStatusOfAccountLinkingProcess method.
+        /// Returned from this method is the ID of the linking process, make sure to save that so that you can check the status of the process later.
+        /// https://ref.lootlocker.com/game-api/#start-account-link
+        /// </summary>
+        /// <param name="onComplete">onComplete Action for handling the response of type LootLockerAccountLinkStartResponse</param>
+        public static void StartAccountLinkingProcess(Action<LootLockerAccountLinkStartResponse> onComplete)
+        {
+            if (!CheckInitialized())
+            {
+                onComplete?.Invoke(LootLockerResponseFactory.SDKNotInitializedError<LootLockerAccountLinkStartResponse>());
+                return;
+            }
+
+            var endpoint = LootLockerEndPoints.StartAccountLinkingProcess;
+
+            LootLockerServerRequest.CallAPI(endpoint.endPoint, endpoint.httpMethod, onComplete: (serverResponse) => { LootLockerResponse.Deserialize(onComplete, serverResponse); });
+        }
+
+        /// <summary>
+        /// Check the status of an ongoing account linking process
+        /// https://ref.lootlocker.com/game-api/#check-account-link-status
+        /// </summary>
+        /// <param name="LinkID">The ID of the account linking process which was returned when starting the linking process</param>
+        /// <param name="onComplete">onComplete Action for handling the response of type LootLockerAccountLinkProcessStatusResponse</param>
+        public static void CheckStatusOfAccountLinkingProcess(string LinkID, Action<LootLockerAccountLinkProcessStatusResponse> onComplete)
+        {
+            if (!CheckInitialized())
+            {
+                onComplete?.Invoke(LootLockerResponseFactory.SDKNotInitializedError<LootLockerAccountLinkProcessStatusResponse>());
+                return;
+            }
+
+            var endpoint = LootLockerEndPoints.CheckStatusOfAccountLinkingProcess;
+
+            LootLockerServerRequest.CallAPI(string.Format(endpoint.endPoint, LinkID), endpoint.httpMethod, onComplete: (serverResponse) => { LootLockerResponse.Deserialize(onComplete, serverResponse); });
+        }
+
+        /// <summary>
+        /// Cancel an ongoing account linking process
+        /// The response will be empty unless an error occurs
+        /// https://ref.lootlocker.com/game-api/#cancel-account-link
+        /// </summary>
+        /// <param name="LinkID">The ID of the account linking process which was returned when starting the linking process</param>
+        /// <param name="onComplete">onComplete Action for handling the response of type LootLockerCancelAccountLinkingProcessResponse</param>
+        public static void CancelAccountLinkingProcess(string LinkID, Action<LootLockerCancelAccountLinkingProcessResponse> onComplete)
+        {
+            if (!CheckInitialized())
+            {
+                onComplete?.Invoke(LootLockerResponseFactory.SDKNotInitializedError<LootLockerCancelAccountLinkingProcessResponse>());
+                return;
+            }
+
+            var endpoint = LootLockerEndPoints.CancelAccountLinkingProcess;
+
+            LootLockerServerRequest.CallAPI(string.Format(endpoint.endPoint, LinkID), endpoint.httpMethod, onComplete: (serverResponse) => { LootLockerResponse.Deserialize(onComplete, serverResponse); });
+        }
+
+        /// <summary>
+        /// Unlink a provider from the currently signed in player
+        /// The response will be empty unless an error occurs
+        /// https://ref.lootlocker.com/game-api/#unlink-provider
+        /// </summary>
+        /// <param name="Provider">What provider to unlink from the currently logged in player</param>
+        /// <param name="onComplete">onComplete Action for handling the response of type LootLockerUnlinkProviderFromAccountResponse</param>
+        public static void UnlinkProviderFromAccount(Platforms Provider, Action<LootLockerUnlinkProviderFromAccountResponse> onComplete)
+        {
+            if (!CheckInitialized())
+            {
+                onComplete?.Invoke(LootLockerResponseFactory.SDKNotInitializedError<LootLockerUnlinkProviderFromAccountResponse>());
+                return;
+            }
+
+            var endpoint = LootLockerEndPoints.UnlinkProviderFromAccount;
+
+            LootLockerServerRequest.CallAPI(string.Format(endpoint.endPoint, CurrentPlatform.GetPlatformRepresentation(Provider).PlatformString), endpoint.httpMethod, onComplete: (serverResponse) => { LootLockerResponse.Deserialize(onComplete, serverResponse); });
+        }
+
+        #endregion
+
         #region Player
         /// <summary>
         /// Get general information about the current current player, such as the XP, Level information and their account balance.

Runtime/Game/Platforms/PlatformManager.cs

@@ -49,8 +49,8 @@ static CurrentPlatform()
             ,"apple_sign_in" // AppleSignIn
             ,"apple_game_center" // Apple Game Center
             ,"android" // Android
-            ,"google" // Google
-            ,"epic" // Epic Online Services / Epic Games
+            ,"google_sign_in" // Google
+            ,"epic_games" // Epic Online Services / Epic Games
         };
         private static readonly string[] PlatformFriendlyStrings = new[]
         {

Runtime/Game/Requests/AccountLinkRequest.cs

@@ -0,0 +1,81 @@
+using LootLocker.LootLockerEnums;
+using LootLocker.Requests;
+using System;
+using System.Collections.Generic;
+using static UnityEngine.UI.CanvasScaler;
+
+namespace LootLocker.LootLockerEnums
+{
+    /*
+     * Possible account linking process statuses. Undefined means that the object couldn't be constructed correctly
+     */
+    public enum LootLockerAccountLinkingProcessStatus
+    {
+        Undefined = 0,
+		Started = 1,
+		Cancelled = 2,
+		Completed = 3
+    };
+}
+
+
+namespace LootLocker.Requests
+{
+    //==================================================
+    // Response Definitions
+    //==================================================
+
+    /*
+     *
+     */
+    public class LootLockerAccountLinkStartResponse : LootLockerResponse
+    {
+        /*
+         * ID of the account linking process. Save this as you will need it for checking the linking process status and if you want to cancel it.
+         */
+        public string Link_id { get; set; }
+        /*
+         * Used by the user in the online account linking process
+         */
+        public string Code { get; set; }
+        /*
+         * Base64 encoded PNG image of a qr code that can be shown to the player for them to scan and open the account linking flow
+         */
+        public string Qr_code { get; set; }
+        /*
+         * URL to where the user can continue the online account linking process
+         */
+        public string Code_page_url { get; set; }
+    };
+
+    /*
+     *
+     */
+    public class LootLockerAccountLinkProcessStatusResponse : LootLockerResponse
+    {
+        /*
+         * Current status of the specified account linking process
+         */
+
+        LootLockerAccountLinkingProcessStatus Status = LootLockerAccountLinkingProcessStatus.Undefined;
+        /*
+         * Time when the specified account linking process was started
+         */
+        public string Created_at { get; set; }
+    };
+
+    /*
+     * This response will be empty unless there's an error
+     */
+    public class LootLockerCancelAccountLinkingProcessResponse : LootLockerResponse
+    {
+    };
+
+    /*
+     * This response will be empty unless there's an error
+     */
+    public class LootLockerUnlinkProviderFromAccountResponse : LootLockerResponse
+    {
+    };
+
+}