Skip to content

Release 3.0.0-preview.6#1141

Merged
mtmk merged 1 commit into
release/3.0from
release-3.0.0-preview.6
May 14, 2026
Merged

Release 3.0.0-preview.6#1141
mtmk merged 1 commit into
release/3.0from
release-3.0.0-preview.6

Conversation

@mtmk

@mtmk mtmk commented May 13, 2026

Copy link
Copy Markdown
Member

Preview release on the 3.0 line bumping version to 3.0.0-preview.6. Brings in everything merged to main since preview.5 via the latest release/3.0 sync: a new server error event on NatsConnection, slnx solution-format migration, README and example docs additions, and a CI matrix bump to nats-server v2.12. No 3.0-only changes.

From main:

Note for reviewer: Windows non-net8.0 CI is flapping on TlsPreferTest, Utf8SubjectMockServerTest, and PingCancellationTest. Linux and Windows net8.0 are green. The pattern correlates with #745 (now in this release), but the failures look like a test-side sync/timing issue rather than a runtime regression: static read of #745 says no-op for the TLS path, and the test relies on a tight race between the server reading the client's first byte and the client tearing down on a TLS-upgrade failure. Tracked in #1142.

@synadia-claude-reviewer

synadia-claude-reviewer Bot commented May 13, 2026

Copy link
Copy Markdown
Contributor

Claude finished @mtmk's task in 43s —— View job


PR Review: Release 3.0.0-preview.6

  • Gather context (PR diff, repo structure)
  • Read CLAUDE.md for repo guidelines (no CLAUDE.md present)
  • Review version.txt change
  • Post review summary

Review Summary

This PR is a clean, minimal version bump — exactly what a preview release PR should be.

Change: version.txt 3.0.0-preview.53.0.0-preview.6

Correctness: The file is consumed directly by src/Directory.Build.props via MSBuild's ReadAllText, so this single change correctly propagates the new version to all NuGet package outputs. The release workflow (release.yml) validates that the git tag matches version.txt at release time, ensuring tag/version consistency.

No issues found. The change is correct, intentional, and consistent with the established versioning pattern for this project. Approving.

@Jarema Jarema left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@mtmk
mtmk merged commit 741f458 into release/3.0 May 14, 2026
30 of 51 checks passed
@mtmk
mtmk deleted the release-3.0.0-preview.6 branch May 14, 2026 07:45
@mtmk mtmk added this to the Release 3.0 milestone May 26, 2026
mtmk added a commit that referenced this pull request May 27, 2026
* Add .NET 10 Target

* Release 3.0.0-preview.1 (#1071)

- Initial release with .NET 10 target
- Also dropped .NET 6 target

* Clean up NET6 and optimize NETSTANDARD (#1072)

* Clean up NET6 and optimize NETSTANDARD

- Remove .NET 5/6/7 from `#if` directives and build
- Delete commented-out file
- Optimize NETSTANDARD encoding polyfills used in hot paths
  to eliminate intermediate array allocations
- Fix `PeriodicTimer` CancellationTokenRegistration leak
- Add encoding polyfill benchmark

* Fix `PeriodicTimer` cancellation to prevent leak

- Ensure static lambda used to avoid allocation.

* Update DI package dependencies and documentation (#1075)

Switch project dependency from `NATS.Net` to `NATS.Client.Simplified` for better modularity. Add `NATS.Extensions.Microsoft.DependencyInjection` to `NATS.Net` dependencies. Update documentation to include comparisons between `NATS.Extensions.Microsoft.DependencyInjection` and `NATS.Client.Hosting`, clarifying usage scenarios. Add new DI guide to advanced docs.

* Release 3.0.0-preview.2 (#1091)

Merged main

* Add message context to serialization interfaces (#1082)

* Add support for optional NATS headers in serialization/deserialization

* Make `Serialize` method header-aware and add unit tests for header serialization logic

* Add recursion guard to prevent infinite loops in default interface methods for `Serialize`/`Deserialize`, update tests and examples accordingly

* Fix `Content-Type` header deserialization by updating to use `StringValues`

* Fix NuidTests flap

* Improve NuidTests stability

* Remove old default methods

* Remove `IDictionary` implementation from `NatsHeaders`

* Add INatsSerializeWithHeaders

* serializer: remove unnecessary obsolete warning pragmas

The CS0618 suppressions were leftover from the DIM approach
where interface members were marked obsolete. No longer needed
with the separate interface design.

* tests: add serialization extension and ABI checks

Add unit tests for NatsSerializationExtensions covering both
the header-aware path and the fallback path for serialize and
deserialize. Make the ABI check program assert correctness
instead of just printing, including the new WithHeaders
interfaces.

* serializer: replace WithHeaders with WithContext interfaces

Replace INatsSerializeWithHeaders<T>/INatsDeserializeWithHeaders<T>
with INatsSerializeWithContext<T>/INatsDeserializeWithContext<T>,
passing a NatsMsgContext struct that carries Subject, ReplyTo, and
Headers.

This gives serializers access to the full message envelope, enabling
subject-based dispatch and reply-to inspection without requiring
further interface changes in the future.

Also fixes the null-headers asymmetry in the extension methods:
both Serialize and Deserialize now always dispatch to the context
overload when the interface is implemented, regardless of whether
Headers is null.

* Revert "Improve NuidTests stability"

This reverts commit 42b8cbd.

* Revert "Fix NuidTests flap"

This reverts commit dcc3588.

* docs: fix stale DIM references and update serialization docs

Remove incorrect DIM claims from serialization docs, rewrite the
headers section to describe the WithContext interface design. Clean
up NativeAot example that had leftover INatsHeaders parameter
overloads from the old DIM approach. Restore dropped <returns>
doc comment on INatsDeserialize<T>.Deserialize.

* headers: drop read-only state

The read-only flag was set on NatsHeaders before passing to publish to
catch accidental mutation after publish. It was a weak guarantee since
headers are copied to a byte buffer synchronously inside CommandWriter,
so post-publish mutation cannot affect wire data anyway.

Removing it lets serializers implementing INatsSerializeWithContext<T>
mutate headers (e.g. set Content-Type) during serialization, which was
otherwise blocked by ThrowIfReadOnly. Telemetry's SetOverrideReadOnly
escape hatch is no longer needed and uses the normal indexer instead.

* tests: add net10.0 TFM and improve ABI checks

Add net10.0 target to CoreUnit, Core, and Core2 test projects.
Add CheckAbiOld control project that runs against the old NuGet
version to prove type forwarding works by contrasting assembly
versions. Centralize the old NuGet version in Directory.Build.props
and make the run script assert loaded assembly versions.

* tests: fix NU1510 package pruning errors on net10.0

Condition System.Net.Http and System.Text.RegularExpressions
package references to net481 only, where they are actually needed.
On net10.0 these are built-in and NuGet's package pruning treats
the unnecessary references as errors.

* serializers: address context review feedback

- NatsMsgContext: require Subject via constructor; drop init setters so
  netstandard shim for IsExternalInit is no longer needed.
- Add INatsSerializerWithContext<T> as a combined interface mirroring
  INatsSerializer<T>, simplifying class declarations for context-aware
  serializer+deserializer pairs.
- Built-in NatsUtf8PrimitivesSerializer, NatsRawSerializer and
  NatsJsonContextSerializer now implement INatsSerializerWithContext<T>
  and propagate the context through _next when delegating. Without this,
  chaining a built-in with a context-aware leaf silently dropped context
  at the leaf.
- Document NatsHeaders thread-safety: not safe to share across concurrent
  publishes, since readonly-locking was removed.
- Document that header-mutating serializers must get non-null headers
  from the caller; the library does not allocate on their behalf.
- Add chain-propagation tests for serialize and deserialize paths.

* sln: remove x64/x86 platform noise

* Release 3.0.0-preview.3 (#1113)

* Use System.Threading.Lock on NET9_0_OR_GREATER (#1118)

* core: use System.Threading.Lock on NET9_0_OR_GREATER

* core: fix reentrant lock in PublishToClientHandlersAsync

* bench: add lock and publish runtime comparison benchmarks

* Release 3.0.0-preview.4 (#1123)

* Release 3.0.0-preview.5 (#1130)

* Release 3.0.0-preview.6 (#1141)

* di: clarify package descriptions for NuGet [no ci]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants