Add GetAttributes and GetAttributesAsync API methods (#14)

* Add GetAttributes and GetAttributesAsync API methods
* Separate project versioning

Author: XDex

Source/Adobe.Target.Client/Adobe.Target.Client.csproj

@@ -8,6 +8,7 @@
     <Product>Adobe.Target.Client</Product>
     <Description>Adobe Target .NET SDK - https://adobetarget-sdks.gitbook.io/docs/sdk-reference-guides/dotnet-sdk</Description>
     <PackageTags>adobe;target;target-sdk;target-client</PackageTags>
+    <MinVerTagPrefix>client-</MinVerTagPrefix>
   </PropertyGroup>
 
   <ItemGroup Label="Project References">

Source/Adobe.Target.Client/ITargetClient.cs

@@ -30,27 +30,43 @@ public interface ITargetClient
         /// </summary>
         /// <param name="request">Target Delivery Request</param>
         /// <returns>Target Delivery Response</returns>
-        public TargetDeliveryResponse GetOffers(TargetDeliveryRequest request);
+        TargetDeliveryResponse GetOffers(TargetDeliveryRequest request);
 
         /// <summary>
         /// Get Offers Async
         /// </summary>
         /// <param name="request">Target Delivery Request</param>
         /// <returns>Target Delivery Response Task</returns>
-        public Task<TargetDeliveryResponse> GetOffersAsync(TargetDeliveryRequest request);
+        Task<TargetDeliveryResponse> GetOffersAsync(TargetDeliveryRequest request);
 
         /// <summary>
         /// Send Notifications
         /// </summary>
         /// <param name="request">Target Delivery Request</param>
         /// <returns>Target Delivery Response</returns>
-        public TargetDeliveryResponse SendNotifications(TargetDeliveryRequest request);
+        TargetDeliveryResponse SendNotifications(TargetDeliveryRequest request);
 
         /// <summary>
         /// Get Offers Async
         /// </summary>
         /// <param name="request">Target Delivery Request</param>
         /// <returns>Target Delivery Response Task</returns>
-        public Task<TargetDeliveryResponse> SendNotificationsAsync(TargetDeliveryRequest request);
+        Task<TargetDeliveryResponse> SendNotificationsAsync(TargetDeliveryRequest request);
+
+        /// <summary>
+        /// Makes a getOffers() call and converts all returned JSON offers into Attributes
+        /// </summary>
+        /// <param name="request">optional TargetDeliveryRequest used to set specific request fields. If null, one will be generated</param>
+        /// <param name="mboxes">Mbox names for attribute retrieval</param>
+        /// <returns>Requested Target attributes</returns>
+        TargetAttributes GetAttributes(TargetDeliveryRequest request, params string[] mboxes);
+
+        /// <summary>
+        /// Makes a getOffers() call and converts all returned JSON offers into Attributes
+        /// </summary>
+        /// <param name="request">optional TargetDeliveryRequest used to set specific request fields. If null, one will be generated</param>
+        /// <param name="mboxes">Mbox names for attribute retrieval</param>
+        /// <returns>Task returning requested Target attributes</returns>
+        Task<TargetAttributes> GetAttributesAsync(TargetDeliveryRequest request, params string[] mboxes);
     }
 }

Source/Adobe.Target.Client/TargetClient.cs

@@ -10,6 +10,8 @@
  */
 namespace Adobe.Target.Client
 {
+    using System.Collections.Generic;
+    using System.Linq;
     using System.Threading.Tasks;
     using Adobe.Target.Client.Model;
     using Adobe.Target.Client.Service;
@@ -107,6 +109,69 @@ public Task<TargetDeliveryResponse> SendNotificationsAsync(TargetDeliveryRequest
             return this.targetService.ExecuteRequestAsync(request);
         }
 
+        /// <inheritdoc />
+        public TargetAttributes GetAttributes(TargetDeliveryRequest request, params string[] mboxes)
+        {
+            var response = this.GetOffers(AddMBoxesToRequest(request, mboxes));
+            return new TargetAttributes(response);
+        }
+
+        /// <inheritdoc />
+        public async Task<TargetAttributes> GetAttributesAsync(TargetDeliveryRequest request, params string[] mboxes)
+        {
+            var response = await this.GetOffersAsync(AddMBoxesToRequest(request, mboxes));
+            return new TargetAttributes(response);
+        }
+
+        private static TargetDeliveryRequest AddMBoxesToRequest(TargetDeliveryRequest request, params string[] mboxes)
+        {
+            if (request?.DeliveryRequest == null)
+            {
+                request = new TargetDeliveryRequest.Builder()
+                    .SetDecisioningMethod(DecisioningMethod.Hybrid)
+                    .SetContext(new Context(ChannelType.Web))
+                    .Build();
+            }
+
+            if (mboxes == null || mboxes.Length == 0)
+            {
+                return request;
+            }
+
+            var existingMboxNames = new HashSet<string>();
+            var index = 0;
+
+            var deliveryRequest = request.DeliveryRequest;
+            var prefetchMboxes = deliveryRequest.Prefetch?.Mboxes ?? new List<MboxRequest>();
+            existingMboxNames.UnionWith(prefetchMboxes.Select(mbox => mbox.Name));
+
+            var executeMboxes = deliveryRequest.Execute?.Mboxes ?? new List<MboxRequest>();
+            executeMboxes.ForEach(mbox =>
+            {
+                if (mbox.Index >= index)
+                {
+                    index = mbox.Index + 1;
+                }
+
+                existingMboxNames.Add(mbox.Name);
+            });
+
+            deliveryRequest.Execute ??= new ExecuteRequest();
+            deliveryRequest.Execute.Mboxes ??= new List<MboxRequest>();
+
+            foreach (var mbox in mboxes)
+            {
+                if (existingMboxNames.Contains(mbox))
+                {
+                    continue;
+                }
+
+                deliveryRequest.Execute.Mboxes.Add(new MboxRequest(name: mbox, index: index++));
+            }
+
+            return request;
+        }
+
         private void UpdatePropertyToken(TargetDeliveryRequest request)
         {
             var property = request.DeliveryRequest.Property;

Source/Adobe.Target.Client/Util/TargetConstants.cs

@@ -18,7 +18,7 @@ public static class TargetConstants
         /// <summary>
         /// SDK Version
         /// </summary>
-        public const string SdkVersion = "1.0.0";
+        public const string SdkVersion = "1.0.1";
 
         /// <summary>
         /// Mbox cookie name

Source/Adobe.Target.Delivery/Adobe.Target.Delivery.csproj

@@ -8,6 +8,7 @@
         <Product>Adobe.Target.Delivery</Product>
         <Description>Target .NET Delivery API - https://developers.adobetarget.com/api/delivery-api/</Description>
         <PackageTags>adobe;target;target-delivery;target-delivery-api</PackageTags>
+        <MinVerTagPrefix>delivery-</MinVerTagPrefix>
     </PropertyGroup>
 
     <ItemGroup>