Changed

• [BC] ViaAggregate() and ViaProcess() now require the root type to be a pointer, enforced via type constraints.
• [BC] StatelessProcessRoot methods now use pointer receivers.

This release introduces ProcessScope.Mutate(), which replaces direct mutation of the process root, giving the engine an explicit signal that state has changed. Existing process handlers that mutate their root directly are now incorrect but will still compile — review all process handlers carefully.

It also renames the "timeout" concept to "deadline", aligning with Go's convention that a deadline is a specific point in time rather than a duration. The semantics are unchanged.

Added

• [BC] Added ProcessScope.Mutate() method.

Changed

• [BC] Renamed Timeout to Deadline.
• [BC] Renamed TimeoutValidationScope to DeadlineValidationScope.
• [BC] Renamed ProcessMessageHandler.HandleTimeout() to HandleDeadline().
• [BC] Renamed ProcessTimeoutScope to ProcessDeadlineScope.
• [BC] Renamed ProcessScope.ScheduleTimeout() to ScheduleDeadline().
• [BC] Renamed NoTimeoutMessagesBehavior to NoDeadlineMessagesBehavior.
• [BC] Renamed SchedulesTimeout() to SchedulesDeadline().
• [BC] Renamed SchedulesTimeoutRoute to SchedulesDeadlineRoute.
• [BC] Renamed SchedulesTimeoutOption to SchedulesDeadlineOption.
• [BC] Renamed RegisterTimeout() to RegisterDeadline().
• [BC] Renamed RegisterTimeoutOption to RegisterDeadlineOption.

This release genericizes AggregateMessageHandler and ProcessMessageHandler by their root type, providing compile-time type safety for aggregate roots and process roots.

Changed

• [BC] StatelessProcessRoot is now an exported struct type instead of a package-level variable.
• [BC] The following types and functions are now parameterized by their concrete AggregateRoot or ProcessRoot type:
  • AggregateMessageHandler
  • AggregateCommandScope
  • ProcessMessageHandler
  • ProcessScope
  • ProcessEventScope
  • ProcessTimeoutScope
  • NoTimeoutMessagesBehavior
  • ViaAggregate()
  • ViaProcess()

Added

• Added UntypedAggregateMessageHandler() and UntypedProcessMessageHandler().
• Added UnwrapHandler() for recursively unwrapping handler adaptors.

Changed

• [BC] ProcessRoot.ProcessInstanceDescription() now accepts an ended parameter that is true if ProcessScope.End() has been called.

Added

• [BC] Added AggregateRoot.AggregateInstanceDescription().
• [BC] Added ProcessRoot.ProcessInstanceDescription().

Changed

• [BC] Callers that use WithIdempotencyKey() must retry ExecuteCommand() until it returns nil, or the command may be lost.

Added

• [ENGINE BC] Added WithEventObserver() to support observing events recorded by a specific invocation of ExecuteCommand().

Added

• Added ConcurrencyPreference enumeration

Changed

• Replaced use of IntegrationConcurrencyPreference and ProjectionConcurrencyPreference with ConcurrencyPreference.

Removed

• [BC] Removed IntegrationConcurrencyPreference type alias.
• [BC] Removed ProjectionConcurrencyPreference type alias.

Added

• [ENGINE BC] Added IntegrationMessageConfigurer.ConcurrencyPreference() method.
• [ENGINE BC] Added ProjectionMessageConfigurer.ConcurrencyPreference() method.
• Added MaximizeConcurrency and MinimizeConcurrency enumeration values for use with the new Concurrency() methods.

Added

• [BC] Added ProjectionMessageHandler.Reset() method.