Merge branch 'development' into enhc/DX-7326

Author: OMpawar-21

.cursor/rules/README.md

@@ -0,0 +1,18 @@
+name: 'Check Branch'
+
+on:
+  pull_request:
+
+jobs:
+  check_branch:
+    runs-on: ubuntu-latest
+    steps:
+      # PRs into master are no longer blocked here based on their source branch.
+      # Direct merges into master (i.e. without going through PR review) are expected
+      # to be prevented by GitHub branch protection rules on master, not by this CI check.
+      - name: Branch check (informational only)
+        run: |
+          echo "This workflow no longer restricts which branch a PR into master can come from."
+          echo "Base branch : ${{ github.base_ref }}"
+          echo "Head branch : ${{ github.head_ref }}"
+          echo "Direct pushes/merges to master should be prevented via branch protection rules, not this workflow."

.github/workflows/back-merge-pr.yml

@@ -13,7 +13,7 @@ jobs:
       - name: Setup .NET Core @ Latest
         uses: actions/setup-dotnet@v1
         with:
-          dotnet-version: "7.0.x"
+          dotnet-version: "10.0.x"
 
       - name: Run Dotnet Restore
         run: dotnet restore

.github/workflows/check-branch.yml

@@ -9,10 +9,10 @@ jobs:
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4.2.2
-      - name: Setup .NET 7.0
+      - name: Setup .NET
         uses: actions/setup-dotnet@v4.3.0
         with:
-          dotnet-version: '7.0.x'
+          dotnet-version: '10.0.x'
       - name: Restore dependencies
         run: dotnet restore Contentstack.Net.sln
       - name: Build solution

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

@@ -67,4 +67,6 @@ packages/
 *.sln.docstates
 
 # Python
-Scripts/venv/
+Scripts/venv/
+# Cached region registry — regenerated at runtime from CDN
+*/Assets/regions.json

.github/workflows/issues-jira.yml

@@ -1,12 +1,102 @@
-### Version: 2.28.0
-#### Date: May-15-2026
+### Version: 3.1.0
+#### Date: Jul-20-2026
 
 ##### Feat:
 - Entry Variants Branch Support
   - Added support for passing an optional `branch` parameter to the `.Variant()` method in both `Entry` and `Query` classes.
   - If the branch parameter is null or empty, it automatically falls back to the Stack's configured branch or "main".
   - Added comprehensive unit and integration tests for Entry and Query variant branch logic.
 
+---
+
+### Version: 3.0.0
+#### Date: Jul-13-2026
+
+##### Breaking Changes:
+- Removed `Newtonsoft.Json` dependency; all JSON serialisation now uses `System.Text.Json` (BCL)
+- `Entry.ToJson()`, `Query.Count()`, `AssetLibrary.Count()` now return `JsonObject` instead of `JObject`
+- `AssetLibrary.Query(JsonObject)` — parameter type changed from `JObject` to `JsonObject`
+- `ContentType.Fetch()`, `GlobalField.Fetch()`, `GlobalFieldQuery.Find()` now return `JsonObject` instead of `JObject`
+- `SerializerSettings` → `SerializerOptions`
+- Model classes use `[JsonPropertyName]` instead of `[JsonProperty]`
+- Requires **.NET 10** or later
+- Updated `contentstack.utils` dependency to `2.0.0` (final, non-beta)
+
+##### Feat:
+- Added `Endpoint` class for dynamic region-to-URL resolution via CDN-backed `regions.json`
+- Added `ContentstackRegionMap` to map `ContentstackRegion` enum to registry region IDs
+- Added `GCP_EU` region support
+- Added `ApiErrorBodyParser` for consistent API error envelope parsing
+- Added `JsonNodeConversion` and `JsonObjectMerge` utilities to replace Newtonsoft equivalents
+- Added `ContentstackJsonDefaults` — shared `JsonSerializerOptions` used across all custom converters
+
+##### Enh:
+- `Config.BaseUrl` now resolves hosts from the regions registry; removed hardcoded `regionCode()` and `HostURL`
+- Replaced `Console.WriteLine` with `Debug.WriteLine` in `ContentstackConvert` to suppress parse warnings from application stdout
+
+##### Chore:
+- Replaced `refresh-region.cs` with `refresh-region.py` — avoids MSBuild compiling the script as source
+- Added `build/contentstack.csharp.targets` to auto-deliver `refresh-region.py` to consumer projects on first build
+- Added `Assets/regions.json` to `.gitignore`
+- Added `EndpointTest.cs`
+- Updated .NET version in SCA scan CI from `7.0.x` to `10.0.x`
+
+##### Migration Guide:
+- See [Migrating from Newtonsoft.Json to System.Text.Json](https://www.contentstack.com/docs/developers/sdks/content-delivery-sdk/dot-net/migrate-dotnet-delivery-sdk-from-newtonsoft.json-to-system.text.json) for the full upgrade path from v2.x.
+
+---
+
+### Version: 3.0.0-beta.2
+#### Date: Jun-22-2026
+
+##### Feat:
+- Added `Endpoint` class for dynamic region-to-URL resolution via CDN-backed `regions.json`
+- Added `ContentstackRegionMap` to map `ContentstackRegion` enum to registry region IDs
+- Added `GCP_EU` region support
+
+##### Enh:
+- `Config.BaseUrl` now resolves hosts from the regions registry; removed hardcoded `regionCode()` and `HostURL`
+
+##### Chore:
+- Replaced `refresh-region.cs` with `refresh-region.py` — avoids MSBuild compiling the script as source
+- Added `build/contentstack.csharp.targets` to auto-deliver `refresh-region.py` to consumer projects on first build
+- Added `Assets/regions.json` to `.gitignore`
+- Added `EndpointTest.cs`
+
+---
+
+### Version: 3.0.0-beta.1
+#### Date: May-04-2026
+
+##### Breaking Changes:
+- Removed `Newtonsoft.Json` dependency; all JSON serialisation now uses `System.Text.Json` (BCL)
+  - `AssetJsonConverter` and `EntryJsonConverter` now implement `System.Text.Json.Serialization.JsonConverter<T>`
+  - `ContentstackCollection<T>` no longer carries `[JsonObject]`; direct `JsonSerializer` usage on this type is not supported
+- Updated `contentstack.utils` from `1.0.6` to `2.0.0-beta.1` (major version bump)
+
+##### Feat:
+- Migrated all internal JSON handling to `System.Text.Json`
+- Added `ApiErrorBodyParser` for consistent API error envelope parsing
+- Added `JsonNodeConversion` and `JsonObjectMerge` utilities to replace Newtonsoft equivalents
+- Added `ContentstackJsonDefaults` — shared `JsonSerializerOptions` used across all custom converters
+
+##### Enh:
+- Replaced `Console.WriteLine` with `Debug.WriteLine` in `ContentstackConvert` to suppress parse warnings from application stdout
+
+##### Chore:
+- Updated .NET version in SCA scan CI from `7.0.x` to `10.0.x`
+
+---
+
+### Version: 2.28.0
+#### Date: Jun-24-2026
+
+##### Fix:
+- Register `EmbeddedObjectConverter` in `ContentstackClient` constructor so `.includeEmbeddedItems().Fetch<T>()` deserializes `_embedded_items` correctly when the model implements `IEntryEmbedable`. No changes required in consumer code.
+- Upgraded utils dependency from `contentstack.utils 1.3.0` to `contentstack.utils 1.4.0` which ships the concrete `EmbeddedObject` class and `EmbeddedObjectConverter`.
+
+---
+
 ### Version: 2.27.0
 #### Date: Apr-23-2026
 
@@ -27,6 +117,8 @@
   - Comprehensive error handling tests for Timeline Preview edge cases
 
 
+---
+
 ### Version: 2.26.0
 #### Date: Feb-10-2026