feature: Add support for getting multisource metadata

Author: Erik Bylund

Runtime/Client/LootLockerEndPoints.cs

@@ -295,6 +295,7 @@ public class LootLockerEndPoints
         // Metadata
         [Header("Metadata")]
         public static EndPointClass listMetadata = new EndPointClass("metadata/source/{0}/id/{1}", LootLockerHTTPMethod.GET);
+        public static EndPointClass getMultisourceMetadata = new EndPointClass("metadata/multisource", LootLockerHTTPMethod.POST);
 
     }
 }

Runtime/Game/LootLockerSDKManager.cs

@@ -5854,8 +5854,25 @@ public static void GetMetadata(LootLockerMetadataSources Source, string SourceID
                 });
             });
         }
+
+        /// <summary>
+        /// List the requested page of Metadata for the specified source that has all of the provided tags and paginate according to the supplied pagination settings
+        /// </summary>
+        /// <param name="SourcesAndKeysToGet> The combination of sources to get keys for, and the keys to get for those sources </param>
+        /// <param name="OnComplete> delegate for handling the server response</param>
+        /// <param name="IgnoreFiles> Optional: Base64 values will be set to content_type "application/x-redacted" and the content will be an empty String. Use this to avoid accidentally fetching large data files.</param>
+        public static void GetMultisourceMetadata(LootLockerMetadataSourceAndKeys[] SourcesAndKeysToGet, Action<LootLockerGetMultisourceMetadataResponse> onComplete, bool ignoreFiles = false)
+        {
+            if (!CheckInitialized())
+            {
+                onComplete?.Invoke(LootLockerResponseFactory.SDKNotInitializedError<LootLockerGetMultisourceMetadataResponse>());
+                return;
+            }
+
+            LootLockerAPIManager.GetMultisourceMetadata(SourcesAndKeysToGet, ignoreFiles, onComplete);
+        }
 #endif
-#endregion
+        #endregion
 
         #region Misc
 

Runtime/Game/Requests/MetadataRequests.cs

@@ -1,6 +1,6 @@
-using LootLocker.LootLockerEnums;
+using System;
+using LootLocker.LootLockerEnums;
 using LootLocker.Requests;
-using System;
 
 #if LOOTLOCKER_USE_NEWTONSOFTJSON
 using Newtonsoft.Json.Linq;
@@ -192,10 +192,56 @@ public bool TryGetValueAsBase64(out LootLockerMetadataBase64Value output)
         }
     }
 
+    /// <summary>
+    /// </summary>
+    public class LootLockerMetadataSourceAndKeys
+    {
+        /// <summary>
+        /// The type of source that the source id refers to
+        /// </summary>
+        public LootLockerMetadataSources source { get; set; }
+        /// <summary>
+        /// The id of the specific source that the set operation was taken on
+        /// </summary>
+        public string id { get; set; }
+        /// <summary>
+        /// A list of keys existing on the specified source
+        /// </summary>
+        public string[] keys { get; set; }
+    }
+
+    /// <summary>
+    /// </summary>
+    public class LootLockerMetadataSourceAndEntries
+    {
+        /// <summary>
+        /// The type of source that the source id refers to
+        /// </summary>
+        public LootLockerMetadataSources source { get; set; }
+        /// <summary>
+        /// The id of the specific source that the set operation was taken on
+        /// </summary>
+        public string source_id { get; set; }
+        /// <summary>
+        /// A list of keys existing on the specified source
+        /// </summary>
+        public LootLockerMetadataEntry[] entries { get; set; }
+    }
+
     //==================================================
     // Request Definitions
     //==================================================
 
+    /// <summary>
+    /// </summary>
+    public class LootLockerGetMultisourceMetadataRequest
+    {
+        /// <summary>
+        /// The source & key combos to get
+        /// </summary>
+        public LootLockerMetadataSourceAndKeys[] sources { get; set; }
+    }
+
     //==================================================
     // Response Definitions
     //==================================================
@@ -222,6 +268,16 @@ public class LootLockerGetMetadataResponse : LootLockerResponse
         /// </summary>
         public LootLockerMetadataEntry entry { get; set; }
     };
+
+    /// <summary>
+    /// </summary>
+    public class LootLockerGetMultisourceMetadataResponse : LootLockerResponse
+    {
+        /// <summary>
+        /// The requested sources with the requested entries for each source
+        /// </summary>
+        public LootLockerMetadataSourceAndEntries[] Metadata { get; set; }
+    };
 }
 
 //==================================================
@@ -260,5 +316,32 @@ public static void ListMetadata(LootLockerMetadataSources Source, string SourceI
                     LootLockerResponse.Deserialize<LootLockerListMetadataResponse>(onComplete, serverResponse);
                 });
         }
+        public static void GetMultisourceMetadata(LootLockerMetadataSourceAndKeys[] SourcesAndKeysToGet, bool ignoreFiles, Action<LootLockerGetMultisourceMetadataResponse> onComplete)
+        {
+            if (SourcesAndKeysToGet == null)
+            {
+                onComplete?.Invoke(LootLockerResponseFactory.InputUnserializableError<LootLockerGetMultisourceMetadataResponse>());
+                return;
+            }
+            string endpoint = LootLockerEndPoints.getMultisourceMetadata.endPoint;
+
+            string queryParams = "";
+            if (ignoreFiles) { queryParams += $"ignore_files=true"; } else { queryParams += $"ignore_files=false"; }
+
+            if (!string.IsNullOrEmpty(queryParams))
+            {
+                queryParams = $"?{queryParams}";
+                endpoint += queryParams;
+            }
+
+            LootLockerGetMultisourceMetadataRequest request = new LootLockerGetMultisourceMetadataRequest { sources = SourcesAndKeysToGet };
+
+            string json = LootLockerJson.SerializeObject(request);
+            LootLockerServerRequest.CallAPI(endpoint, LootLockerEndPoints.getMultisourceMetadata.httpMethod, json, onComplete:
+                (serverResponse) =>
+                {
+                    LootLockerResponse.Deserialize<LootLockerGetMultisourceMetadataResponse>(onComplete, serverResponse);
+                });
+        }
     }
 }