Fix/363 dynamic values

.gitignore

@@ -141,7 +141,7 @@ publish/
 # Publish Web Output
 *.[Pp]ublish.xml
 *.azurePubxml
-# TODO: Comment the next line if you want to checkin your web deploy settings
+# INFO: Comment the next line if you want to checkin your web deploy settings
 # but database connection strings (with potential passwords) will be unencrypted
 *.pubxml
 *.publishproj

Kontent.Ai.Delivery.Abstractions/ContentItems/Elements/IContentElementValue.cs

@@ -1,15 +1,21 @@
 namespace Kontent.Ai.Delivery.Abstractions
 {
     /// <summary>
-    /// Represents a content element.
+    /// Represents a generic content element with value.
     /// </summary>
-    public interface IContentElementValue<out T>
+    public interface IContentElementValue<out T> : IContentElementValue
     {
         /// <summary>
         /// Gets the value of the content element.
         /// </summary>
         T Value { get; }
+    }
 
+    /// <summary>
+    /// Represents a content element.
+    /// </summary>
+    public interface IContentElementValue
+    {
         /// <summary>
         /// Gets the codename of the content element.
         /// </summary>

Kontent.Ai.Delivery.Abstractions/ContentItems/Universal/IDeliveryUniversalItemListingResponse.cs

@@ -0,0 +1,15 @@
+using System.Collections.Generic;
+
+namespace Kontent.Ai.Delivery.Abstractions
+{
+    public interface IDeliveryUniversalItemListingResponse : IResponse, IPageable
+    {
+        /// <summary>
+        /// Gets the content item.
+        /// </summary>
+        IList<IUniversalContentItem> Items { get; }
+
+
+        Dictionary<string, IUniversalContentItem> LinkedItems { get; }
+    }
+}

Kontent.Ai.Delivery.Abstractions/ContentItems/Universal/IDeliveryUniversalItemResponse.cs

@@ -0,0 +1,17 @@
+using System.Collections.Generic;
+
+namespace Kontent.Ai.Delivery.Abstractions
+{
+    /// <summary>
+    /// Represents a response from Kontent.ai Delivery API that contains a content item.
+    /// </summary>
+    public interface IDeliveryUniversalItemResponse: IDeliveryItemResponse<IUniversalContentItem>, IResponse
+    {
+        /// <summary>
+        /// Gets the content item.
+        /// </summary>
+        IUniversalContentItem Item { get; }
+
+        Dictionary<string, IUniversalContentItem> LinkedItems { get; }
+    }
+}

Kontent.Ai.Delivery.Abstractions/ContentItems/Universal/IUniversalContentItem.cs

@@ -0,0 +1,16 @@
+using System.Collections.Generic;
+
+namespace Kontent.Ai.Delivery.Abstractions
+{
+    /// <summary>
+    /// Dynamic representation of the content item dynamic item processing.
+    /// Values are based on <see cref="Kontent.Ai.Delivery.Abstractions.IContentElementValue{T}"/>
+    /// </summary>
+    public interface IUniversalContentItem : IContentItem
+    {
+        /// <summary>
+        /// Represents content items elements.
+        /// </summary>
+        public Dictionary<string, IContentElementValue> Elements { get; set; }
+    }
+}

Kontent.Ai.Delivery.Abstractions/ContentItems/Universal/IUniversalItemModelProvider.cs

@@ -0,0 +1,20 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+
+namespace Kontent.Ai.Delivery.Abstractions
+{
+    /// <summary>
+    /// Interface ensuring mapping dynamic response to <see cref="IUniversalContentItem"/>.
+    /// </summary>
+    public interface IUniversalItemModelProvider
+    {
+        /// <summary>
+        /// Builds a model based on given JSON input.
+        /// </summary>
+        /// <param name="item">Content item data.</param>
+        /// <returns>Universal item</returns>
+        public Task<IUniversalContentItem> GetUniversalContentItemModelAsync(object item);
+    }
+}

Kontent.Ai.Delivery.Abstractions/IDeliveryClient.cs

@@ -17,6 +17,15 @@ public interface IDeliveryClient
         /// <returns>The <see cref="IDeliveryItemResponse{T}"/> instance that contains the content item with the specified codename.</returns>
         Task<IDeliveryItemResponse<T>> GetItemAsync<T>(string codename, IEnumerable<IQueryParameter> parameters = null);
 
+
+        /// <summary>
+        /// Returns item and its linked items in the <see cref="IUniversalContentItem"/> form.
+        /// </summary>
+        /// <param name="codename">The codename of a content item.</param>
+        /// <param name="parameters">A collection of query parameters, for example for projection or depth of linked items.</param>
+        /// <returns>The <see cref="IDeliveryUniversalItemResponse"/> instance that contains the content item and linked items with the specified codename.</returns>
+        Task<IDeliveryUniversalItemResponse> GetUniversalItemAsync(string codename, IEnumerable<IQueryParameter> parameters = null);
+
         /// <summary>
         /// Returns strongly typed content items that match the optional filtering parameters. By default, retrieves one level of linked items.
         /// </summary>
@@ -25,6 +34,13 @@ public interface IDeliveryClient
         /// <returns>The <see cref="IDeliveryItemListingResponse{T}"/> instance that contains the content items. If no query parameters are specified, all content items are returned.</returns>
         Task<IDeliveryItemListingResponse<T>> GetItemsAsync<T>(IEnumerable<IQueryParameter> parameters = null);
 
+        /// <summary>
+        /// Returns <see cref="IUniversalContentItem"/> content items that match the optional filtering parameters. By default, retrieves one level of linked items.
+        /// </summary>
+        /// <param name="parameters">A collection of query parameters, for example, for filtering, ordering, or setting the depth of linked items.</param>
+        /// <returns>The <see cref="IDeliveryUniversalItemListingResponse" /> instance that contains the content items. If no query parameters are specified, all content items in the first page are returned.</returns>
+        Task<IDeliveryUniversalItemListingResponse> GetUniversalItemsAsync(IEnumerable<IQueryParameter> parameters = null);
+
         /// <summary>
         /// Returns a feed that is used to traverse through strongly typed content items matching the optional filtering parameters.
         /// </summary>