chore(deps)!: update Microsoft.Azure.Cosmos to 3.62.0

[xperiandri]

Proposed Changes

Updates Microsoft.Azure.Cosmos from 3.60.0 to 3.62.0, split from #35. 3.62.0 is the version the SDK changelog names the minimum recommended one. Relevant changes for this library:

• ReadManyItemsAsync uses a point read when a physical partition has a single requested (id, partition key) pair;
• 449 (RetryWith) responses on the gateway and thin client paths are retried client-side for up to 30 s (60 s when the account default consistency is Strong);
• System.Text.Json converters for the Spatial geometry types, which ADR 0001 relies on for geospatial support;
• since 3.61.0 the SDK appends id to the partition key when /id is the last path of a hierarchical key.

Types of changes

• Bugfix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)

The package now requires Microsoft.Azure.Cosmos 3.62.0 or later. That release enables thin client mode by default, which sends data-plane traffic over HTTP/2 on port 10250 and does not support resource-token authentication; consumers who use resource tokens or allow outbound traffic on port 443 only opt out with AZURE_COSMOS_THIN_CLIENT_ENABLED=false. Recorded in the CHANGELOG.

Checklist

• Build and tests pass locally
• I have added tests that prove my fix is effective or that my feature works (if appropriate)
• I have added necessary documentation (if appropriate)

Further comments

• Based on main (net8.0): Debug and Release builds have the same 19 warnings as main; Fantomas leaves no diff; tests 119/119 in Debug and Release against the local emulator with 4 workers; the packed nuspec depends on Microsoft.Azure.Cosmos 3.62.0.
• chore!: target net10.0 #37 also adds an Unreleased section to CHANGELOG.md; the one merged second needs a rebase that keeps both bullets.

🤖 Generated with Claude Code

[Copilot]

Copilot review overview

🟢 Approval recommended

The version bump is valid, centrally managed, and accurately documented.

Review effort: Balanced
Findings: None

What changed in this PR

Updates the Cosmos DB SDK dependency to its minimum recommended release and documents the associated breaking behavior.

Changes:

• Bumps Microsoft.Azure.Cosmos from 3.60.0 to 3.62.0.
• Documents thin-client defaults and the resource-token opt-out.

File	Description
Directory.Packages.props	Updates the centrally managed SDK version.
CHANGELOG.md	Records the dependency and behavioral changes.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.