feat(7323): Add System.Text.Json support for ContentstackClient, Login, Organization, Stack with backward compatibility

Contentstack.Management.Core.Unit.Tests/Mokes/MockHttpResponse.cs

@@ -3,6 +3,7 @@
 using System.Net;
 using Contentstack.Management.Core;
 using Newtonsoft.Json.Linq;
+using System.Text.Json.Nodes;
 
 namespace Contentstack.Management.Core.Unit.Tests.Mokes
 {
@@ -85,5 +86,36 @@ public TResponse OpenTResponse<TResponse>()
                 return default(TResponse);
             }
         }
+
+        public JsonObject OpenJsonObjectResponse()
+        {
+            if (string.IsNullOrEmpty(_responseContent))
+                return new JsonObject();
+
+            try
+            {
+                return JsonNode.Parse(_responseContent)?.AsObject() ?? new JsonObject();
+            }
+            catch
+            {
+                // Return empty JsonObject if parsing fails
+                return new JsonObject();
+            }
+        }
+
+        public TResponse OpenTResponseStj<TResponse>()
+        {
+            if (string.IsNullOrEmpty(_responseContent))
+                return default(TResponse);
+
+            try
+            {
+                return System.Text.Json.JsonSerializer.Deserialize<TResponse>(_responseContent);
+            }
+            catch
+            {
+                return default(TResponse);
+            }
+        }
     }
 } 

Contentstack.Management.Core/ContentstackClient.cs

@@ -19,6 +19,9 @@
 using Environment = System.Environment;
 using System.Collections.Generic;
 using Contentstack.Management.Core.Runtime.Pipeline.RetryHandler;
+using System.Text.Json;
+using Contentstack.Management.Core.Enums;
+using Contentstack.Management.Core.Services.Serialization;
 
 namespace Contentstack.Management.Core
 {
@@ -29,7 +32,9 @@
     {
         internal ContentstackRuntimePipeline ContentstackPipeline { get; set; }
         internal ContentstackClientOptions contentstackOptions;
-        internal JsonSerializer serializer => JsonSerializer.Create(SerializerSettings);
+        internal Newtonsoft.Json.JsonSerializer serializer => Newtonsoft.Json.JsonSerializer.Create(SerializerSettings);
+        internal ISerializationEngine SerializationEngine => SerializationEngineFactory.Create(
+            SerializationMode, SerializerSettings, SerializerOptions);
 
         #region Private
         private HttpClient _httpClient;
@@ -53,6 +58,16 @@
         /// </summary>
         public JsonSerializerSettings SerializerSettings { get; set; } = new JsonSerializerSettings();
 
+        /// <summary>
+        /// Get and Set method for System.Text.Json serialization options.
+        /// </summary>
+        public JsonSerializerOptions SerializerOptions { get; set; } = new JsonSerializerOptions();
+
+        /// <summary>
+        /// Get and Set method for controlling which serialization engine to use.
+        /// </summary>
+        public SerializationMode SerializationMode { get; set; } = SerializationMode.Newtonsoft;
+
         #endregion
 
         #region Constructor
@@ -125,7 +140,7 @@
         /// </code></pre>
         /// </example>
         public ContentstackClient(
             string authtoken = null,
             string host = "api.contentstack.io",
             int port = 443,
             string version = "v3",
@@ -372,7 +387,7 @@
         public ContentstackResponse Login(ICredentials credentials, string token = null, string mfaSecret = null)
         {
             ThrowIfAlreadyLoggedIn();
-            LoginService Login = new LoginService(serializer, credentials, token, mfaSecret);
+            LoginService Login = new LoginService(serializer, credentials, token, mfaSecret, SerializerOptions, SerializationMode);
 
             return InvokeSync(Login);
         }
@@ -394,7 +409,7 @@
         public Task<ContentstackResponse> LoginAsync(ICredentials credentials, string token = null, string mfaSecret = null)
         {
             ThrowIfAlreadyLoggedIn();
-            LoginService Login = new LoginService(serializer, credentials, token, mfaSecret);
+            LoginService Login = new LoginService(serializer, credentials, token, mfaSecret, SerializerOptions, SerializationMode);
 
             return InvokeAsync<LoginService, ContentstackResponse>(Login);
         }
@@ -434,7 +449,7 @@
         public ContentstackResponse Logout(string authtoken = null)
         {
             string token = authtoken ?? contentstackOptions.Authtoken;
-            LogoutService logout = new LogoutService(serializer, token);
+            LogoutService logout = new LogoutService(serializer, token, SerializerOptions, SerializationMode);
 
             return InvokeSync(logout);
         }
@@ -452,7 +467,7 @@
         public Task<ContentstackResponse> LogoutAsync(string authtoken = null)
         {
             string token = authtoken ?? contentstackOptions.Authtoken;
-            LogoutService logout = new LogoutService(serializer, token);
+            LogoutService logout = new LogoutService(serializer, token, SerializerOptions, SerializationMode);
 
             return InvokeAsync<LogoutService, ContentstackResponse>(logout);
         }
@@ -677,7 +692,7 @@
         {
             ThrowIfNotLoggedIn();
 
-            GetLoggedInUserService getUser = new GetLoggedInUserService(serializer, collection);
+            GetLoggedInUserService getUser = new GetLoggedInUserService(serializer, collection, SerializerOptions, SerializationMode);
 
             return InvokeSync(getUser);
         }
@@ -696,7 +711,7 @@
         {
             ThrowIfNotLoggedIn();
 
-            GetLoggedInUserService getUser = new GetLoggedInUserService(serializer, collection);
+            GetLoggedInUserService getUser = new GetLoggedInUserService(serializer, collection, SerializerOptions, SerializationMode);
 
             return InvokeAsync<GetLoggedInUserService, ContentstackResponse>(getUser);
         }

Contentstack.Management.Core/ContentstackResponse.cs

@@ -1,11 +1,13 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Net;
 using System.Net.Http;
 using System.Net.Http.Headers;
 using Newtonsoft.Json;
 using Newtonsoft.Json.Linq;
+using System.Text.Json;
+using System.Text.Json.Nodes;
 
 namespace Contentstack.Management.Core
 {
@@ -20,7 +22,8 @@
         Dictionary<string, string> _headers;
         HashSet<string> _headerNamesSet;
         private readonly HttpResponseMessage _response;
-        private readonly JsonSerializer _serializer;
+        private readonly Newtonsoft.Json.JsonSerializer _serializer;
+        private readonly JsonSerializerOptions _stjOptions;
 
         #region Public
         /// <summary>
@@ -126,10 +129,11 @@
         }
         #endregion
 
-        internal ContentstackResponse(HttpResponseMessage response, JsonSerializer serializer)
+        internal ContentstackResponse(HttpResponseMessage response, Newtonsoft.Json.JsonSerializer serializer, JsonSerializerOptions stjOptions = null)
         {
             _response = response;
             _serializer = serializer;
+            _stjOptions = stjOptions ?? new JsonSerializerOptions();
 
             this.StatusCode = response.StatusCode;
             this.IsSuccessStatusCode = response.IsSuccessStatusCode;
@@ -175,6 +179,28 @@
             return jObject.ToObject<TResponse>(_serializer);
         }
 
+        /// <summary>
+        /// System.Text.Json JsonObject format response.
+        /// </summary>
+        /// <returns>The JsonObject.</returns>
+        public JsonObject OpenJsonObjectResponse()
+        {
+            ThrowIfDisposed();
+            return JsonNode.Parse(OpenResponse())?.AsObject();
+        }
+
+        /// <summary>
+        /// Type response to serialize the response using System.Text.Json.
+        /// </summary>
+        /// <typeparam name="TResponse">The type to serialize the response into.</typeparam>
+        /// <returns></returns>
+        public TResponse OpenTResponseStj<TResponse>()
+        {
+            ThrowIfDisposed();
+            string json = OpenResponse();
+            return System.Text.Json.JsonSerializer.Deserialize<TResponse>(json, _stjOptions);
+        }
+
 
         #region Dispose method
         public void Dispose()

Contentstack.Management.Core/Enums/SerializationMode.cs

@@ -0,0 +1,23 @@
+namespace Contentstack.Management.Core.Enums
+{
+    /// <summary>
+    /// Defines the serialization mode for JSON operations.
+    /// </summary>
+    public enum SerializationMode
+    {
+        /// <summary>
+        /// Use Newtonsoft.Json for serialization (default for backward compatibility).
+        /// </summary>
+        Newtonsoft = 0,
+
+        /// <summary>
+        /// Use System.Text.Json for serialization.
+        /// </summary>
+        SystemTextJson = 1,
+
+        /// <summary>
+        /// Auto-detect best serialization mode based on context (future implementation).
+        /// </summary>
+        Auto = 2
+    }
+}

Contentstack.Management.Core/Exceptions/ContentstackErrorException.cs

@@ -1,10 +1,11 @@
-using System;
+using System;
 using System.Collections.Generic;
 using System.Net;
 using System.Net.Http;
 using System.Net.Http.Headers;
 using Newtonsoft.Json;
 using Newtonsoft.Json.Linq;
+using System.Text.Json.Serialization;
 
 namespace Contentstack.Management.Core.Exceptions
 {
@@ -42,6 +43,7 @@ public class ContentstackErrorException: Exception
         /// This is error message.
         /// </summary>
         [JsonProperty("error_message")]
+        [JsonPropertyName("error_message")]
         public string ErrorMessage
         {
             get
@@ -59,12 +61,14 @@ public string ErrorMessage
         /// This is error code.
         /// </summary>
         [JsonProperty("error_code")]
+        [JsonPropertyName("error_code")]
         public int ErrorCode { get; set; }
 
         /// <summary>
         /// Set of errors in detail.
         /// </summary>
         [JsonProperty("errors")]
+        [JsonPropertyName("errors")]
         public Dictionary<string, object> Errors { get; set; }
 
         /// <summary>

Contentstack.Management.Core/Http/ContentstackHttpRequest.cs

@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Net.Http;
 using System.Threading.Tasks;
 using System.Net.Http.Headers;
@@ -8,6 +8,7 @@
 using System.IO;
 using Newtonsoft.Json;
 using Contentstack.Management.Core.Exceptions;
+using System.Text.Json;
 
 namespace Contentstack.Management.Core.Http
 {
@@ -17,7 +18,8 @@ internal class ContentstackHttpRequest: IHttpRequest
         private bool _disposed = false;
         private readonly HttpClient _httpClient;
         private readonly HttpRequestMessage _request;
-        private readonly JsonSerializer _serializer;
+        private readonly Newtonsoft.Json.JsonSerializer _serializer;
+        private readonly JsonSerializerOptions _stjOptions;
         #endregion
 
         #region Public
@@ -54,10 +56,11 @@ public HttpRequestMessage Request
         #endregion
 
         #region Constructor
-        internal ContentstackHttpRequest(HttpClient httpClient, JsonSerializer serializer)
+        internal ContentstackHttpRequest(HttpClient httpClient, Newtonsoft.Json.JsonSerializer serializer, JsonSerializerOptions stjOptions = null)
         {
             _httpClient = httpClient;
             _serializer = serializer;
+            _stjOptions = stjOptions ?? new JsonSerializerOptions();
             _request = new HttpRequestMessage();
         }
         #endregion
@@ -126,14 +129,14 @@ public async Task<IResponse> GetResponseAsync()
 
                 if (responseMessage.StatusCode >= HttpStatusCode.Ambiguous &&
                     responseMessage.StatusCode < HttpStatusCode.BadRequest)
-                    return new ContentstackResponse(responseMessage, _serializer);
+                    return new ContentstackResponse(responseMessage, _serializer, _stjOptions);
 
                 if (!responseMessage.IsSuccessStatusCode)
                 {
                     throw ContentstackErrorException.CreateException(responseMessage);
                 }
 
-                return new ContentstackResponse(responseMessage, _serializer);
+                return new ContentstackResponse(responseMessage, _serializer, _stjOptions);
             }
             catch (HttpRequestException httpException)
             {

Contentstack.Management.Core/IResponse.cs

@@ -1,6 +1,7 @@
-using System;
+using System;
 using System.Net;
 using Newtonsoft.Json.Linq;
+using System.Text.Json.Nodes;
 
 namespace Contentstack.Management.Core
 {
@@ -22,5 +23,18 @@ public interface IResponse
         JObject OpenJObjectResponse();
 
         TResponse OpenTResponse<TResponse>();
+
+        /// <summary>
+        /// Opens the response as a System.Text.Json JsonObject.
+        /// </summary>
+        /// <returns>JsonObject representation of the response.</returns>
+        JsonObject OpenJsonObjectResponse();
+
+        /// <summary>
+        /// Deserializes the response to the specified type using System.Text.Json.
+        /// </summary>
+        /// <typeparam name="TResponse">The type to deserialize to.</typeparam>
+        /// <returns>Deserialized object of the specified type.</returns>
+        TResponse OpenTResponseStj<TResponse>();
     }
 }