feat: Add support for discord authentication

Author: kirre-bylund

Runtime/Client/LootLockerEndPoints.cs

@@ -13,6 +13,8 @@ public class LootLockerEndPoints
         public static EndPointClass endingSession = new EndPointClass("v1/session", LootLockerHTTPMethod.DELETE);
         public static EndPointClass nintendoSwitchSessionRequest = new EndPointClass("session/nintendo-switch", LootLockerHTTPMethod.POST);
         public static EndPointClass epicSessionRequest = new EndPointClass("session/epic", LootLockerHTTPMethod.POST);
+        public static EndPointClass discordSessionRequest = new EndPointClass("session/discord", LootLockerHTTPMethod.POST);
+        public static EndPointClass discordRefreshSessionRequest = new EndPointClass("session/discord", LootLockerHTTPMethod.POST);
         public static EndPointClass metaSessionRequest = new EndPointClass("session/meta", LootLockerHTTPMethod.POST);
         public static EndPointClass xboxSessionRequest = new EndPointClass("session/xbox-one", LootLockerHTTPMethod.POST);
         public static EndPointClass appleSessionRequest = new EndPointClass("session/apple", LootLockerHTTPMethod.POST);

Runtime/Game/LootLockerSDKManager.cs

@@ -1460,6 +1460,134 @@ public static void RefreshMetaSession(string refresh_token, Action<LootLockerMet
             );
         }
 
+        /// <summary>
+        /// Start a Discord session.
+        /// The Discord platform must be enabled and configured in the web console for this to work.
+        /// A game can support multiple platforms, but it is recommended that a build only supports one platform.
+        /// </summary>
+        /// <param name="accessToken">The player's Discord OAuth token</param>
+        /// <param name="onComplete">onComplete Action for handling the response</param>
+        public static void StartDiscordSession(string accessToken, Action<LootLockerDiscordSessionResponse> onComplete)
+        {
+            if (!CheckInitialized(true))
+            {
+                onComplete?.Invoke(null);
+                return;
+            }
+
+            LootLockerServerRequest.CallAPI(null,
+                LootLockerEndPoints.discordSessionRequest.endPoint,
+                LootLockerEndPoints.discordSessionRequest.httpMethod,
+                LootLockerJson.SerializeObject(new LootLockerDiscordSessionRequest(accessToken)),
+                (serverResponse) =>
+                    {
+                        var response = LootLockerResponse.Deserialize<LootLockerDiscordSessionResponse>(serverResponse);
+                        if (response.success)
+                        {
+                            LootLockerStateData.SetPlayerData(new LootLockerPlayerData
+                            {
+                                SessionToken = response.session_token,
+                                RefreshToken = response.refresh_token,
+                                ULID = response.player_ulid,
+                                Identifier = "",
+                                PublicUID = response.public_uid,
+                                LegacyID = response.player_id,
+                                Name = response.player_name,
+                                WhiteLabelEmail = "",
+                                WhiteLabelToken = "",
+                                CurrentPlatform = LootLockerAuthPlatform.GetPlatformRepresentation(LL_AuthPlatforms.Discord),
+                                LastSignIn = DateTime.Now,
+                                CreatedAt = response.player_created_at,
+                                WalletID = response.wallet_id,
+                            });
+                        }
+
+                        onComplete?.Invoke(response);
+                    }, 
+                false
+            );
+        }
+
+        /// <summary>
+        /// Refresh a previous Discord session
+        /// A response code of 400 (Bad request) could mean that the refresh token has expired and you'll need to sign in again
+        /// The Discord platform must be enabled and configured in the web console for this to work.
+        /// </summary>
+        /// <param name="onComplete">onComplete Action for handling the response</param>
+        /// <param name="forPlayerWithUlid">Optional : Execute the request for the specified player. If not supplied, the default player will be used.</param>
+        public static void RefreshDiscordSession(Action<LootLockerDiscordSessionResponse> onComplete, string forPlayerWithUlid = null)
+        {
+            var playerData = LootLockerStateData.GetStateForPlayerOrDefaultStateOrEmpty(forPlayerWithUlid);
+            if (string.IsNullOrEmpty(playerData?.RefreshToken))
+            {
+                onComplete?.Invoke(LootLockerResponseFactory.TokenExpiredError<LootLockerDiscordSessionResponse>(playerData?.ULID));
+                return;
+            }
+
+            RefreshDiscordSession(playerData.RefreshToken, onComplete, forPlayerWithUlid);
+        }
+
+        /// <summary>
+        /// Refresh a previous Discord session
+        /// If you do not want to manually handle the refresh token we recommend using the RefreshDiscordSession(Action<LootLockerDiscordSessionResponse> onComplete, string forPlayerWithUlid) method.
+        /// A response code of 400 (Bad request) could mean that the refresh token has expired and you'll need to sign in again
+        /// The Discord platform must be enabled and configured in the web console for this to work.
+        /// </summary>
+        /// <param name="refresh_token">Token received in response from StartDiscordSession request</param>
+        /// <param name="onComplete">onComplete Action for handling the response of type LootLockerDiscordSessionResponse</param>
+        /// <param name="forPlayerWithUlid">Optional : Execute the request for the specified player. If not supplied, the default player will be used.</param>
+        public static void RefreshDiscordSession(string refresh_token, Action<LootLockerDiscordSessionResponse> onComplete, string forPlayerWithUlid = null)
+        {
+            if (!CheckInitialized(true))
+            {
+                onComplete?.Invoke(LootLockerResponseFactory.SDKNotInitializedError<LootLockerDiscordSessionResponse>(forPlayerWithUlid));
+                return;
+            }
+
+            if (string.IsNullOrEmpty(refresh_token))
+            {
+                var playerData = LootLockerStateData.GetStateForPlayerOrDefaultStateOrEmpty(forPlayerWithUlid);
+                if (string.IsNullOrEmpty(playerData?.RefreshToken))
+                {
+                    onComplete?.Invoke(LootLockerResponseFactory.TokenExpiredError<LootLockerDiscordSessionResponse>(playerData?.ULID));
+                    return;
+                }
+                refresh_token = playerData.RefreshToken;
+                forPlayerWithUlid = playerData.ULID;
+            }
+
+            LootLockerServerRequest.CallAPI(forPlayerWithUlid, 
+                LootLockerEndPoints.discordSessionRequest.endPoint, LootLockerEndPoints.discordSessionRequest.httpMethod, 
+                LootLockerJson.SerializeObject(new LootLockerDiscordRefreshSessionRequest(refresh_token)), 
+                (serverResponse) =>
+                {
+                    var response = LootLockerResponse.Deserialize<LootLockerDiscordSessionResponse>(serverResponse);
+                    if (response.success)
+                    {
+                        LootLockerStateData.SetPlayerData(new LootLockerPlayerData
+                        {
+                            SessionToken = response.session_token,
+                            RefreshToken = response.refresh_token,
+                            ULID = response.player_ulid,
+                            Identifier = "",
+                            PublicUID = response.public_uid,
+                            LegacyID = response.player_id,
+                            Name = response.player_name,
+                            WhiteLabelEmail = "",
+                            WhiteLabelToken = "",
+                            CurrentPlatform = LootLockerAuthPlatform.GetPlatformRepresentation(LL_AuthPlatforms.Discord),
+                            LastSignIn = DateTime.Now,
+                            CreatedAt = response.player_created_at,
+                            WalletID = response.wallet_id,
+                        });
+                    }
+
+                    onComplete?.Invoke(response);
+                }, 
+                false
+            );
+        }
+
         /// <summary>
         /// End active session (if any exists)
         /// Succeeds if a session was ended or no sessions were active

Runtime/Game/Platforms/PlatformManager.cs

@@ -21,6 +21,7 @@ public enum LL_AuthPlatforms
     ,Epic
     ,Meta
     ,Remote
+    ,Discord
     }
     public struct LL_AuthPlatformRepresentation
     {
@@ -31,7 +32,7 @@ public struct LL_AuthPlatformRepresentation
 
     public class LootLockerAuthPlatformSettings
     {
-        public static List<LL_AuthPlatforms> PlatformsWithRefreshTokens = new List<LL_AuthPlatforms> { LL_AuthPlatforms.AppleGameCenter, LL_AuthPlatforms.AppleSignIn, LL_AuthPlatforms.Epic, LL_AuthPlatforms.Google, LL_AuthPlatforms.GooglePlayGames, LL_AuthPlatforms.Remote };
+        public static List<LL_AuthPlatforms> PlatformsWithRefreshTokens = new List<LL_AuthPlatforms> { LL_AuthPlatforms.AppleGameCenter, LL_AuthPlatforms.AppleSignIn, LL_AuthPlatforms.Epic, LL_AuthPlatforms.Google, LL_AuthPlatforms.GooglePlayGames, LL_AuthPlatforms.Remote, LL_AuthPlatforms.Discord };
         public static List<LL_AuthPlatforms> PlatformsWithStoredAuthData = new List<LL_AuthPlatforms> { LL_AuthPlatforms.Guest, LL_AuthPlatforms.WhiteLabel, LL_AuthPlatforms.AmazonLuna, LL_AuthPlatforms.PlayStationNetwork, LL_AuthPlatforms.XboxOne };
     }
 
@@ -68,6 +69,7 @@ static LootLockerAuthPlatform()
             ,"epic_games" // Epic Online Services / Epic Games
             ,"meta" // Meta
             ,"remote" // Remote (leased) session
+            ,"discord" // Discord
         };
 
         private static readonly string[] PlatformFriendlyStrings = new[]
@@ -88,6 +90,7 @@ static LootLockerAuthPlatform()
             ,"Epic Online Services" // Epic Online Services / Epic Games
             ,"Meta" // Meta
             ,"Remote" // Remote (leased) session
+            ,"Discord" // Discord
         };
 
         public static LL_AuthPlatformRepresentation GetPlatformRepresentation(LL_AuthPlatforms platform)

Runtime/Game/Requests/LootLockerSessionRequest.cs

@@ -367,4 +367,34 @@ public LootLockerAppleGameCenterRefreshSessionRequest(string refreshToken)
             this.refresh_token = refreshToken;
         }
     }
+    public class LootLockerDiscordSessionRequest
+    {
+        public string game_key => LootLockerConfig.current.apiKey;
+        public string access_token { get; set; }
+        public string game_version => LootLockerConfig.current.game_version;
+
+        public LootLockerDiscordSessionRequest(string accessToken)
+        {
+            this.access_token = accessToken;
+        }
+    }
+
+    public class LootLockerDiscordRefreshSessionRequest
+    {
+        public string game_key => LootLockerConfig.current.apiKey;
+        public string refresh_token { get; set; }
+        public string game_version => LootLockerConfig.current.game_version;
+
+        public LootLockerDiscordRefreshSessionRequest(string refreshToken)
+        {
+            this.refresh_token = refreshToken;
+        }
+    }
+
+    [Serializable]
+    public class LootLockerDiscordSessionResponse : LootLockerSessionResponse
+    {
+        public string refresh_token { get; set; }
+        public string player_identifier { get; set; }
+    }
 }