add type resolution support, refactor, adjust method descriptions

Kontent.Ai.Delivery.Abstractions/Sync/IDeliverySyncInitResponse.cs

@@ -3,7 +3,7 @@
 namespace Kontent.Ai.Delivery.Abstractions;
 
 /// <summary>
-/// Represents a response from Kontent.ai Delivery API that contains a continuation token and .
+/// Represents a response from Kontent.ai Sync API. Response includes continuation token for subsequent synchronization calls. Sync initialization should always return an empty list.
 /// </summary>
 public interface IDeliverySyncInitResponse : IResponse
 {

Kontent.Ai.Delivery.Abstractions/Sync/ISyncItem.cs

@@ -7,7 +7,10 @@ namespace Kontent.Ai.Delivery.Abstractions;
 /// </summary>
 public interface ISyncItem
 {
-    ISyncItemData Data { get; }
+    /// <summary>
+    /// Retrieves content item information and element values.
+    /// </summary>
+    object Data { get; }
 
     /// <summary>
     /// Gets the information whether the content item was modified or deleted since the last synchronization.

Kontent.Ai.Delivery.Caching/DeliveryClientCache.cs

@@ -160,7 +160,7 @@ public async Task<IDeliveryLanguageListingResponse> GetLanguagesAsync(IEnumerabl
         /// <summary>
         /// Initializes synchronization of changes in content items based on the specified parameters. After the initialization, you'll get an X-Continuation token in the response.
         /// </summary>
-        /// <param name="parameters">A collection of query parameters, for example, for filtering.</param>
+        /// <param name="parameters">A collection of query parameters, for example to limit synchronization to only a subset of collections or content types.</param>
         /// <returns>The <see cref="IDeliverySyncInitResponse"/> instance that represents the sync init response that contains continuation token needed for further sync execution.</returns>
         public Task<IDeliverySyncInitResponse> PostSyncInitAsync(IEnumerable<IQueryParameter> parameters = null)
         {

Kontent.Ai.Delivery/DeliveryClient.cs

@@ -314,6 +314,11 @@ public async Task<IDeliveryLanguageListingResponse> GetLanguagesAsync(IEnumerabl
             return new DeliveryLanguageListingResponse(response, languages.ToList<ILanguage>(), pagination);
         }
 
+        /// <summary>
+        /// Initializes synchronization of changes in content items based on the specified parameters. After the initialization, you'll get an X-Continuation token in the response.
+        /// </summary>
+        /// <param name="parameters">A collection of query parameters, for example to limit synchronization to only a subset of collections or content types.</param>
+        /// <returns>The <see cref="IDeliverySyncInitResponse"/> instance that represents the sync init response that contains continuation token needed for further sync execution.</returns>
         public async Task<IDeliverySyncInitResponse> PostSyncInitAsync(IEnumerable<IQueryParameter> parameters = null)
         {
             var endpointUrl = UrlBuilder.GetSyncInitUrl(parameters);
@@ -329,6 +334,10 @@ public async Task<IDeliverySyncInitResponse> PostSyncInitAsync(IEnumerable<IQuer
             return new DeliverySyncInitResponse(response, items.ToList<ISyncItem>());
         }
 
+        /// <summary>
+        /// Retrieve a list of delta updates to recently changed content items in the specified project. The types of items you get is determined by the X-Continuation token you use.
+        /// </summary>
+        /// <returns>The <see cref="IDeliverySyncResponse"/> instance that represents the sync response that contains collection of delta updates and continuation token needed for further sync execution.</returns>
         public async Task<IDeliverySyncResponse> GetSyncAsync(string continuationToken)
         {
             var endpointUrl = UrlBuilder.GetSyncUrl();
@@ -340,10 +349,23 @@ public async Task<IDeliverySyncResponse> GetSyncAsync(string continuationToken)
             }
 
             var content = await response.GetJsonContentAsync();
-            var items = content["items"].ToObject<List<SyncItem>>(Serializer);
-            return new DeliverySyncResponse(response, items.ToList<ISyncItem>());
+            var syncItems = content["items"].ToObject<List<SyncItem>>(Serializer);
+
+            var itemModels = await Task.WhenAll(syncItems.Select(async syncItem =>
+            {
+                // use TypeProvider from DI container to select a model
+                var mappedModel = await ModelProvider.GetContentItemModelAsync<object>(syncItem.Data, new JObject());
+                if (mappedModel == null)
+                {
+                    // return JObject if no suitable model is found
+                    return new SyncItem(syncItem.Data, syncItem.ChangeType, syncItem.Timestamp);
+                }
+                return new SyncItem(mappedModel, syncItem.ChangeType, syncItem.Timestamp);
+            }));
+            return new DeliverySyncResponse(response, itemModels);
         }
 
+
         private async Task<ApiResponse> GetDeliveryResponseAsync(string endpointUrl, HttpMethod httpMethod, string continuationToken = null)
         {
             if (DeliveryOptions.CurrentValue.UsePreviewApi && DeliveryOptions.CurrentValue.UseSecureAccess)

Kontent.Ai.Delivery/Sync/DeliverySyncResponse.cs

@@ -22,7 +22,7 @@ internal DeliverySyncResponse(IApiResponse response, IList<ISyncItem> syncItems)
         SyncItems = syncItems;
     }
 
-    internal DeliverySyncResponse(IApiResponse response) 
+    internal DeliverySyncResponse(IApiResponse response)
         : base(response)
     {
     }

Kontent.Ai.Delivery/Sync/SyncItem.cs

@@ -7,21 +7,22 @@
 namespace Kontent.Ai.Delivery.Sync;
 
 /// <inheritdoc/>
-internal sealed class SyncItem : ISyncItem
+/// <summary>
+/// Constructor used for deserialization (e.g. for caching purposes), contains no logic.
+/// </summary>
+[method: JsonConstructor]
+/// <<inheritdoc/>>
+internal sealed class SyncItem(object data, string changeType, DateTime timestamp) : ISyncItem
 {
+    /// <inheritdoc/>
     [JsonProperty("data")]
-    public ISyncItemData Data { get; internal set; }
+    public object Data { get; internal set; } = data;
 
+    /// <inheritdoc/>
     [JsonProperty("change_type")]
-    public string ChangeType { get; internal set; }
+    public string ChangeType { get; internal set; } = changeType;
 
+    /// <inheritdoc/>
     [JsonProperty("timestamp")]
-    public DateTime Timestamp { get; internal set; }
-
-    [JsonConstructor]
-    public SyncItem(ISyncItemData data, string changeType, DateTime timestamp) {
-        Data = data;
-        ChangeType = changeType;
-        Timestamp = timestamp;
-    }
+    public DateTime Timestamp { get; internal set; } = timestamp;
 }