fix: add EmbeddedObject and EmbeddedObjectConverter to resolve IEmbeddedObject deserialization failure

CHANGELOG.md

@@ -1,3 +1,9 @@
+### Version: 1.3.1
+#### Date: June-23-2026
+- Added `EmbeddedObject` as a concrete implementation of `IEmbeddedObject`, covering both `IEmbeddedEntry` and `IEmbeddedAsset`.
+- Added `EmbeddedObjectConverter` to resolve `IEmbeddedObject` during JSON deserialization without requiring changes in consumer code.
+- Custom fields on embedded entries and assets are preserved via `[JsonExtensionData]`.
+
 ### Version: 1.3.0
 
 #### Date: May-11-2026

Contentstack.Utils/Converters/EmbeddedObjectConverter.cs

@@ -0,0 +1,34 @@
+using System;
+using Contentstack.Utils.Interfaces;
+using Contentstack.Utils.Models;
+using Newtonsoft.Json;
+using Newtonsoft.Json.Linq;
+
+namespace Contentstack.Utils.Converters
+{
+    // Resolves IEmbeddedObject to EmbeddedObject during deserialization.
+    // CanConvert uses exact type match so customer-defined subclasses are not intercepted.
+    public class EmbeddedObjectConverter : JsonConverter
+    {
+        public override bool CanConvert(Type objectType)
+            => objectType == typeof(IEmbeddedObject);
+
+        public override bool CanWrite => false;
+
+        public override object ReadJson(JsonReader reader, Type objectType,
+            object existingValue, JsonSerializer serializer)
+        {
+            if (reader.TokenType == JsonToken.Null)
+                return null;
+
+            var jo = JObject.Load(reader);
+            var result = new EmbeddedObject();
+            serializer.Populate(jo.CreateReader(), result);
+            return result;
+        }
+
+        public override void WriteJson(JsonWriter writer, object value, JsonSerializer serializer)
+            => throw new NotSupportedException(
+                "EmbeddedObjectConverter is read-only. Serialize EmbeddedObject directly.");
+    }
+}

Contentstack.Utils/Models/EmbeddedObject.cs

@@ -0,0 +1,30 @@
+using System.Collections.Generic;
+using Contentstack.Utils.Interfaces;
+using Newtonsoft.Json;
+using Newtonsoft.Json.Linq;
+namespace Contentstack.Utils.Models
+{
+    // Concrete class used by EmbeddedObjectConverter when deserializing _embedded_items.
+    // Implements both IEmbeddedEntry and IEmbeddedAsset to cover entries and assets.
+    public class EmbeddedObject : IEmbeddedEntry, IEmbeddedAsset
+    {
+        [JsonProperty("uid")]
+        public string Uid { get; set; } = string.Empty;
+
+        [JsonProperty("_content_type_uid")]
+        public string ContentTypeUid { get; set; } = string.Empty;
+
+        [JsonProperty("title")]
+        public string Title { get; set; } = string.Empty;
+
+        [JsonProperty("filename")]
+        public string FileName { get; set; } = string.Empty;
+
+        [JsonProperty("url")]
+        public string Url { get; set; } = string.Empty;
+
+        // Any field not explicitly declared above (custom fields, locale data, etc.)
+        [JsonExtensionData]
+        public IDictionary<string, JToken> Fields { get; set; } = new Dictionary<string, JToken>();
+    }
+}

Directory.Build.props

@@ -1,5 +1,5 @@
 <Project>
   <PropertyGroup>
-    <Version>1.3.0</Version>
+    <Version>1.3.1</Version>
   </PropertyGroup>
 </Project>