Enhc/beta

.github/workflows/check-version-bump.yml

@@ -82,7 +82,7 @@ jobs:
           LATEST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || true)
           if [ -z "$LATEST_TAG" ]; then
             echo "No existing tags found. Skipping semver vs tag check."
-            CHANGELOG_HEAD=$(sed -nE 's/^## \[v?([0-9]+\.[0-9]+\.[0-9]+)\].*/\1/p' CHANGELOG.md | head -1)
+            CHANGELOG_HEAD=$(sed -nE 's/^## \[v?([0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z][0-9A-Za-z.-]*)?)\].*/\1/p' CHANGELOG.md | head -1)
             if [ -z "$CHANGELOG_HEAD" ]; then
               echo "::error::Could not find a ## [vX.Y.Z] entry at the top of CHANGELOG.md."
               exit 1
@@ -105,7 +105,7 @@ jobs:
             exit 1
           fi
 
-          CHANGELOG_HEAD=$(sed -nE 's/^## \[v?([0-9]+\.[0-9]+\.[0-9]+)\].*/\1/p' CHANGELOG.md | head -1)
+          CHANGELOG_HEAD=$(sed -nE 's/^## \[v?([0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z][0-9A-Za-z.-]*)?)\].*/\1/p' CHANGELOG.md | head -1)
           if [ -z "$CHANGELOG_HEAD" ]; then
             echo "::error::Could not find a ## [vX.Y.Z] entry at the top of CHANGELOG.md."
             exit 1

.github/workflows/nuget-publish.yml

@@ -6,40 +6,46 @@ on:
     types: [created]
 
 jobs:
-  publish-nuget:  
+  publish-nuget:
     runs-on: windows-latest
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4.2.2
       - name: Setup .NET Core @ Latest
         uses: actions/setup-dotnet@v4.3.0
+        with:
+          dotnet-version: 10.0.x
         env:
           NUGET_AUTH_TOKEN: ${{ secrets.NUGET_API_KEY }}
       - name: Build solution and generate NuGet package
         run: |
           dotnet pack -c Release -o out
 
-      - name: Push generated package to GitHub registry
+      - name: Push generated package to NuGet.org
         run: |
           cd out
           dotnet nuget push "contentstack.management.csharp.*.nupkg" --api-key ${{ secrets.NUGET_API_KEY }} --skip-duplicate --no-symbols --source https://api.nuget.org/v3/index.json
 
-  publish-git:  
+  publish-git:
     runs-on: windows-latest
+    permissions:
+      contents: read
+      packages: write
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4.2.2
       - name: Setup .NET Core @ Latest
         uses: actions/setup-dotnet@v4.3.0
         with:
+          dotnet-version: 10.0.x
           source-url: https://nuget.pkg.github.com/Contentstack/index.json
         env:
           NUGET_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       - name: Build solution and generate NuGet package
         run: |
           dotnet pack -c Release -o out
 
-      - name: Push generated package to GitHub registry
+      - name: Push generated package to GitHub Packages
         run: |
           cd out
-          dotnet nuget push "contentstack.management.csharp.*.nupkg" --api-key ${{ secrets.NUGET_API_KEY }} --skip-duplicate --no-symbols --source https://api.nuget.org/v3/index.json
+          dotnet nuget push "contentstack.management.csharp.*.nupkg" --api-key ${{ secrets.GITHUB_TOKEN }} --skip-duplicate --no-symbols --source https://nuget.pkg.github.com/Contentstack/index.json

.gitignore

@@ -25,8 +25,8 @@ packages/
 */appSettings.json
 api_referece/*
 .sonarqube/
-*.html
 *.cobertura.xml
 integration-test-report_*.html
 *.zip
-.trx
+.trx
+*.html

CHANGELOG.md

@@ -1,7 +1,46 @@
 # Changelog
 
-
-## [v0.10.0](https://github.com/contentstack/contentstack-management-dotnet/tree/v0.9.0)
+## [v1.0.0-beta.2](https://github.com/contentstack/contentstack-management-dotnet/tree/v1.0.0-beta.2)(2026-06-22)
+
+ - **Chore**
+   - Replaced `Scripts/refresh-region.cs` with `Scripts/refresh-region.py` — prevents MSBuild from compiling the script as source code
+   - Added SSL fallback in `refresh-region.py` for macOS certificate verification failures
+   - Updated `contentstack.management.csharp.targets` and `contentstack.management.core.csproj` to package and deliver the `.py` script
+ - **Fix**
+   - Bulk operation tests: accept `401 Unauthorized` alongside `404/400` for invalid/expired job ID assertions
+   - Bulk operation tests: made workflow stage assignment non-fatal in `Test002` to prevent failures when workflow API is unavailable
+ - **Test**
+   - **Image format upload coverage**
+     - Added `Test100_Should_Upload_JPEG_Image_Asset` — uploads `london.jpg` via `image/jpeg` MIME type and verifies `Created` status and `content_type` in response
+     - Added `Test101_Should_Upload_JPEG_Extension_Image_Asset` — uploads `tokyo.jpeg` (`.jpeg` extension) and asserts `image/jpeg` content type
+     - Added `Test102_Should_Upload_AVIF_Image_Asset` — uploads `dubai.avif` via `image/avif` MIME type and accepts `image/avif` or `application/octet-stream` content type
+     - Added `Test103_Should_Upload_Multiple_Image_Formats_Sequentially` — uploads all three images in sequence and asserts `Created` on each
+     - Added `Test104_Should_Fetch_Uploaded_Image_Asset_Metadata` — creates a JPEG asset and fetches it back, asserting `uid`, `filename`, `content_type`, and `file_size` fields are present
+     - Added `Test105_Should_Update_Uploaded_Image_Asset` — creates a JPEG asset then replaces it with a different JPEG and verifies the `200 OK` update response
+     - Test image files (`london.jpg`, `tokyo.jpeg`, `dubai.avif`) live under `Contentstack.Management.Core.Tests/Mock/assets/`
+
+## [v1.0.0-beta.1](https://github.com/contentstack/contentstack-management-dotnet/tree/v1.0.0-beta.1)(2026-06-15)
+ - **Feat**
+   - **Branch support**
+     - Added `Branch` model with `Create`, `CreateAsync`, `Fetch`, `FetchAsync`, `Delete`, `DeleteAsync`, and `Query` operations
+     - `Stack.Branch(uid?)` accessor follows the same pattern as other stack resources
+ - **Breaking Change**
+   - **Complete migration from Newtonsoft.Json to System.Text.Json**
+     - `Newtonsoft.Json` is no longer a dependency — remove it from your project once your own code no longer references it directly
+     - `client.SerializerSettings` (`JsonSerializerSettings`) replaced by `client.SerializerOptions` (`JsonSerializerOptions`)
+     - `response.OpenJObjectResponse()` removed — use `response.OpenJsonObjectResponse()` (`JsonObject`) or `response.OpenTResponse<T>()` instead
+     - `JObjectParameterValue` now accepts `System.Text.Json.Nodes.JsonNode` instead of `Newtonsoft.Json.Linq.JObject`
+     - All `[JsonProperty]` attributes replaced with `[JsonPropertyName]`; `[JsonObject(ItemNullValueHandling)]` removed in favour of `DefaultIgnoreCondition = WhenWritingNull` on `SerializerOptions`
+     - All modules fully migrated to System.Text.Json: AuditLog, Branch, BulkOperation, ContentType, DeliveryToken, Entry, EntryVariant, Environment, Extension, GlobalField, Label, Locale, ManagementToken, Organization, Release, Role, Stack, Taxonomy, Term, User, VariantGroup, Webhook, and Workflow
+     - OAuth auto token refresh wired into the request pipeline
+     - Upgraded target framework to .NET 10
+ - **New:** Multi-region endpoint resolution via `Endpoint.GetContentstackEndpoint(region, service)` — resolves Contentstack service URLs for all 7 supported regions (NA, EU, AU, Azure-NA, Azure-EU, GCP-NA, GCP-EU) and 18 service keys (contentManagement, contentDelivery, auth, graphqlDelivery, preview, images, assets, automate, launch, developerHub, brandKit, genAI, personalizeManagement, personalizeEdge, composableStudio, assetManagement, and more).
+ - **New:** `omitHttps` flag strips the `https://` scheme from returned URLs — pass directly to `ContentstackClientOptions.Host` (e.g. `new ContentstackClientOptions { Host = Endpoint.GetContentstackEndpoint("eu", "contentManagement", omitHttps: true) }`).
+ - **New:** Case-insensitive region alias support — `"us"`, `"NA"`, `"AWS-NA"`, `"azure_na"` all resolve correctly to the same region.
+ - **New:** `regions.json` registry auto-downloaded from `artifacts.contentstack.com` on first use and cached on disk — no setup required. The SDK self-heals if the file is missing.
+ - **New:** `Scripts/refresh-region.cs` bundled inside the NuGet package — automatically placed in your project's `Scripts/` folder on first `dotnet build`. Run `dotnet run Scripts/refresh-region.cs` anytime to pull the latest regions from CDN.
+
+## [v0.10.0](https://github.com/contentstack/contentstack-management-dotnet/tree/v0.10.0)
  - Feat
    - **Enhanced Error Handling and Test Coverage (DX-5436)**
      - Added comprehensive error handling across all models with enhanced `ContentstackErrorException`

Contentstack.Management.Core.Tests/Contentstack.Management.Core.Tests.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
-    <TargetFramework>net7.0</TargetFramework>
+    <TargetFramework>net10.0</TargetFramework>
 
     <IsPackable>false</IsPackable>
     <ReleaseVersion>$(Version)</ReleaseVersion>
@@ -24,8 +24,6 @@
     <PackageReference Include="AutoFixture.AutoMoq" Version="4.18.1" />
     <PackageReference Include="Moq" Version="4.20.72" />
     <PackageReference Include="Microsoft.AspNetCore.Http" Version="2.3.0" />
-    <PackageReference Include="Newtonsoft.Json" Version="13.0.4" />
-    <PackageReference Include="System.Text.RegularExpressions" Version="4.3.1" />
   </ItemGroup>
 
   <ItemGroup>
@@ -52,4 +50,5 @@
   <ItemGroup>
     <ProjectReference Include="..\Contentstack.Management.Core\contentstack.management.core.csproj" />
   </ItemGroup>
+
 </Project>

Contentstack.Management.Core.Tests/Contentstack.cs

@@ -11,8 +11,8 @@
 using Contentstack.Management.Core.Tests.Model;
 using Microsoft.Extensions.Configuration;
 using Microsoft.Extensions.Options;
-using Newtonsoft.Json;
-using Newtonsoft.Json.Linq;
+using System.Text.Json;
+using System.Text.Json.Nodes;
 
 namespace Contentstack.Management.Core.Tests
 {
@@ -242,17 +242,15 @@ public static ContentstackClient CreateAuthenticatedClient()
             return client;
         }
 
-        public static T serialize<T>(JsonSerializer serializer, string filePath)
+        public static T serialize<T>(JsonSerializerOptions options, string filePath)
         {
             string response = GetResourceText(filePath);
-            JObject jObject = JObject.Parse(response);
-            return jObject.ToObject<T>(serializer);
+            return JsonSerializer.Deserialize<T>(response, options);
         }
-        public static T serializeArray<T>(JsonSerializer serializer, string filePath)
+        public static T serializeArray<T>(JsonSerializerOptions options, string filePath)
         {
             string response = GetResourceText(filePath);
-            JArray jObject = JArray.Parse(response);
-            return jObject.ToObject<T>(serializer);
+            return JsonSerializer.Deserialize<T>(response, options);
         }
 
         public static string GetResourceText(string resourceName)

Contentstack.Management.Core.Tests/Helpers/ContentTypeFixtureLoader.cs

@@ -1,6 +1,6 @@
 using Contentstack.Management.Core.Models;
-using Newtonsoft.Json;
-using Newtonsoft.Json.Linq;
+using System.Text.Json;
+using System.Text.Json.Nodes;
 
 namespace Contentstack.Management.Core.Tests.Helpers
 {
@@ -9,15 +9,15 @@ namespace Contentstack.Management.Core.Tests.Helpers
     /// </summary>
     public static class ContentTypeFixtureLoader
     {
-        public static ContentModelling LoadFromMock(JsonSerializer serializer, string embeddedFileName, string uidSuffix)
+        public static ContentModelling LoadFromMock(JsonSerializerOptions options, string embeddedFileName, string uidSuffix)
         {
             var text = Contentstack.GetResourceText(embeddedFileName);
-            var jo = JObject.Parse(text);
-            var baseUid = jo["uid"]?.Value<string>() ?? "ct";
+            var jo = JsonNode.Parse(text)!.AsObject();
+            var baseUid = jo["uid"]?.GetValue<string>() ?? "ct";
             jo["uid"] = $"{baseUid}_{uidSuffix}";
-            var title = jo["title"]?.Value<string>() ?? "CT";
+            var title = jo["title"]?.GetValue<string>() ?? "CT";
             jo["title"] = $"{title} {uidSuffix}";
-            return jo.ToObject<ContentModelling>(serializer);
+            return JsonSerializer.Deserialize<ContentModelling>(jo.ToJsonString(), options);
         }
     }
 }

Contentstack.Management.Core.Tests/Helpers/MockHttpStatusHandler.cs

@@ -5,7 +5,7 @@
 using System.Text;
 using System.Threading;
 using System.Threading.Tasks;
-using Newtonsoft.Json;
+using System.Text.Json;
 
 namespace Contentstack.Management.Core.Tests.Helpers
 {
@@ -44,7 +44,7 @@ protected override async Task<HttpResponseMessage> SendAsync(
                 errors = _additionalFields
             };
 
-            var jsonContent = JsonConvert.SerializeObject(errorResponse);
+            var jsonContent = JsonSerializer.Serialize(errorResponse);
             var response = new HttpResponseMessage(_statusCode)
             {
                 Content = new StringContent(jsonContent, Encoding.UTF8, "application/json"),

Contentstack.Management.Core.Tests/Helpers/TestOutputLogger.cs

@@ -1,6 +1,6 @@
 using System;
 using System.Collections.Generic;
-using Newtonsoft.Json;
+using System.Text.Json;
 
 namespace Contentstack.Management.Core.Tests.Helpers
 {
@@ -64,7 +64,7 @@ private static void Emit(object data)
         {
             try
             {
-                var json = JsonConvert.SerializeObject(data, Formatting.None);
+                var json = JsonSerializer.Serialize(data);
                 Console.Write(START_MARKER);
                 Console.Write(json);
                 Console.WriteLine(END_MARKER);

Contentstack.Management.Core.Tests/IntegrationTest/Contentstack001_LoginTest.cs

@@ -8,7 +8,7 @@
 using Contentstack.Management.Core.Tests.Helpers;
 using Microsoft.VisualStudio.TestTools.UnitTesting;
 using Contentstack.Management.Core.Queryable;
-using Newtonsoft.Json.Linq;
+using System.Text.Json;
 
 namespace Contentstack.Management.Core.Tests.IntegrationTest
 {
@@ -145,7 +145,7 @@ public void Test005_Should_Return_Loggedin_User()
 
                 ContentstackResponse response = client.GetUser();
 
-                var user = response.OpenJObjectResponse();
+                var user = response.OpenJsonObjectResponse();
 
                 AssertLogger.IsNotNull(user, "user");
 
@@ -169,11 +169,11 @@ public async System.Threading.Tasks.Task Test006_Should_Return_Loggedin_User_Asy
 
                 ContentstackResponse response = await client.GetUserAsync();
 
-                var user = response.OpenJObjectResponse();
+                var user = response.OpenJsonObjectResponse();
 
                 AssertLogger.IsNotNull(user, "user");
                 AssertLogger.IsNotNull(user["user"]["organizations"], "organizations");
-                AssertLogger.IsInstanceOfType(user["user"]["organizations"], typeof(JArray), "organizations");
+                AssertLogger.IsInstanceOfType(user["user"]["organizations"], typeof(System.Text.Json.Nodes.JsonArray), "organizations");
                 AssertLogger.IsNull(user["user"]["organizations"][0]["org_roles"], "org_roles");
 
             }
@@ -199,11 +199,11 @@ public void Test007_Should_Return_Loggedin_User_With_Organizations_detail()
 
                 ContentstackResponse response = client.GetUser(collection);
 
-                var user = response.OpenJObjectResponse();
+                var user = response.OpenJsonObjectResponse();
 
                 AssertLogger.IsNotNull(user, "user");
                 AssertLogger.IsNotNull(user["user"]["organizations"], "organizations");
-                AssertLogger.IsInstanceOfType(user["user"]["organizations"], typeof(JArray), "organizations");
+                AssertLogger.IsInstanceOfType(user["user"]["organizations"], typeof(System.Text.Json.Nodes.JsonArray), "organizations");
                 AssertLogger.IsNotNull(user["user"]["organizations"][0]["org_roles"], "org_roles");
             }
             catch (Exception e)
@@ -1000,7 +1000,7 @@ public void Test056_Should_Handle_Malformed_JSON_Response_Sync()
             {
                 AssertLogger.IsTrue(true, "ContentstackErrorException acceptable for malformed JSON");
             }
-            catch (Newtonsoft.Json.JsonException)
+            catch (System.Text.Json.JsonException)
             {
                 AssertLogger.IsTrue(true, "JsonException acceptable for malformed JSON");
             }
@@ -1027,7 +1027,7 @@ public async System.Threading.Tasks.Task Test057_Should_Handle_Malformed_JSON_Re
             {
                 AssertLogger.IsTrue(true, "ContentstackErrorException acceptable for malformed JSON");
             }
-            catch (Newtonsoft.Json.JsonException)
+            catch (System.Text.Json.JsonException)
             {
                 AssertLogger.IsTrue(true, "JsonException acceptable for malformed JSON");
             }
@@ -1058,7 +1058,7 @@ public void Test058_Should_Handle_Empty_Response_Body_Sync()
             {
                 AssertLogger.IsTrue(true, "ArgumentException acceptable for empty response");
             }
-            catch (Newtonsoft.Json.JsonReaderException)
+            catch (System.Text.Json.JsonException)
             {
                 AssertLogger.IsTrue(true, "JsonReaderException acceptable for empty response");
             }
@@ -1089,7 +1089,7 @@ public async System.Threading.Tasks.Task Test059_Should_Handle_Empty_Response_Bo
             {
                 AssertLogger.IsTrue(true, "ArgumentException acceptable for empty response");
             }
-            catch (Newtonsoft.Json.JsonReaderException)
+            catch (System.Text.Json.JsonException)
             {
                 AssertLogger.IsTrue(true, "JsonReaderException acceptable for empty response");
             }
@@ -1141,7 +1141,7 @@ public void Test060_Should_Handle_Unexpected_Response_Structure_Sync()
             {
                 AssertLogger.IsTrue(true, "KeyNotFoundException acceptable for unexpected structure");
             }
-            catch (Newtonsoft.Json.JsonException)
+            catch (System.Text.Json.JsonException)
             {
                 AssertLogger.IsTrue(true, "JsonException acceptable for unexpected structure");
             }
@@ -1284,8 +1284,9 @@ public void Test069_Should_Handle_GetUser_With_Extremely_Large_Parameters_Sync()
             catch (ContentstackErrorException errorException)
             {
                 AssertLogger.IsTrue(errorException.StatusCode == HttpStatusCode.BadRequest ||
-                                  errorException.StatusCode == HttpStatusCode.RequestEntityTooLarge,
-                                  "Expected 400 or 413 for large parameters");
+                                  errorException.StatusCode == HttpStatusCode.RequestEntityTooLarge ||
+                                  errorException.StatusCode == HttpStatusCode.RequestUriTooLong,
+                                  "Expected 400, 413, or 414 for large parameters");
             }
             catch (Exception e)
             {
@@ -1393,7 +1394,7 @@ public void Test073_Should_Handle_GetUser_Malformed_Response_Sync()
             {
                 AssertLogger.IsTrue(true, "ContentstackErrorException acceptable for malformed response");
             }
-            catch (Newtonsoft.Json.JsonException)
+            catch (System.Text.Json.JsonException)
             {
                 AssertLogger.IsTrue(true, "JsonException acceptable for malformed response");
             }
@@ -1513,7 +1514,7 @@ public void Test088_Should_Handle_TOTP_Token_Format_Variations_Sync()
                 {
                     client.Login(credentials, token);
                 }
-                catch (ArgumentException ex) when (token.Length != 6 || token.Any(c => !char.IsDigit(c)))
+                catch (ArgumentException) when (token.Length != 6 || token.Any(c => !char.IsDigit(c)))
                 {
                     AssertLogger.IsTrue(true, $"ArgumentException for invalid token format: '{token}'");
                 }
@@ -1856,7 +1857,7 @@ public async System.Threading.Tasks.Task Test100_Should_Validate_Complete_Error_
                 {
                     results.Add((scenario, false, "TaskCanceledException"));
                 }
-                catch (Newtonsoft.Json.JsonException)
+                catch (System.Text.Json.JsonException)
                 {
                     results.Add((scenario, false, "JsonException"));
                 }