Skip to content

Release 3.0.0-preview.4#1123

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

Release 3.0.0-preview.4#1123
mtmk merged 1 commit into
release/3.0from
release-3.0.0-preview.4

Conversation

@mtmk

@mtmk mtmk commented May 1, 2026

Copy link
Copy Markdown
Member

Preview release on the 3.0 line bumping version to 3.0.0-preview.4. Brings in everything from 2.8.0-preview.2 via the latest main sync, plus the 3.0-only switch to System.Threading.Lock on net9.0+. Adds nats-server v2.14 support for fast-ingest batch publishing via the new AllowBatchPublish field on StreamConfig (ADR-50).

3.0-only since preview.3:

From main (also in 2.8.0-preview.2):

@synadia-claude-reviewer

synadia-claude-reviewer Bot commented May 1, 2026

Copy link
Copy Markdown
Contributor

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


PR Review: Release 3.0.0-preview.4

  • Read CLAUDE.md for repo guidelines
  • Examine PR diff
  • Review version.txt change
  • Post review summary

Review Summary

This is a clean, minimal version bump PR — the only change is version.txt: 3.0.0-preview.33.0.0-preview.4.

Version wiring looks correct. src/Directory.Build.props reads the version directly from version.txt via MSBuild's System.IO.File::ReadAllText, so this single-file change propagates consistently to all NuGet packages without additional modifications needed.

No other hardcoded version strings found in .cs, .csproj, .props, or .md files that would need to be updated alongside this bump.

Targets look consistent with PR claims. The build targets netstandard2.0;netstandard2.1;net8.0;net10.0 — the NET9_0_OR_GREATER conditional used by the System.Threading.Lock change (#1118) evaluates true when targeting net10.0, so the 3.0-only feature is correctly covered without needing an explicit net9.0 TFM.

No issues found. The change is correct and complete.

@MauriceVanVeen MauriceVanVeen 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 a5c1121 into release/3.0 May 1, 2026
28 of 32 checks passed
@mtmk
mtmk deleted the release-3.0.0-preview.4 branch May 1, 2026 11:51
@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