Skip to content

Releases: eventflow/EventFlow

v0.17.1134

28 Sep 11:32

Choose a tag to compare

  • Fixed: Using NuGet package EventFlow.Autofac causes an exception with the
    message The type 'EventFlow.Configuration.Registrations.AutofacStartable' is not assignable to service 'Autofac.IStartable during EventFlow setup

v0.16.1120

27 Sep 18:04

Choose a tag to compare

  • Breaking: Removed HasRegistrationFor<> and GetRegisteredServices()
    from IServiceRegistration and added them to IResolver instead. The
    methods required that all service registrations went through EventFlow,
    which in most cases they will not
  • Obsolete: Marked IServiceRegistration.RegisterIfNotRegistered(...), use
    the keepDefault = true on the other Register(...) methods instead
  • New: Major changes have been done to how EventFlow handles service
    registration and bootstrapping in order for developers to skip calling
    CreateResolver() (or CreateContainer() if using the EventFlow.Autofac
    package) completely. EventFlow will register its bootstrap services in the
    IoC container and configure itself whenever the container is created
  • New: Introduced IBootstrap interface that you can register. It has a
    single BootAsync(...) method that will be called as soon as the IoC
    container is ready (similar to that of IStartable of Autofac)
  • Fixed: Correct order of service registration decorators. They are now
    applied in the same order they are applied, e.g., the last registered
    service decorator will be the "outer" service
  • Fixed: Added missing ICommand<,> interface to abstract Command<,> class in
    EventFlow.Commands.

v0.15.1057

24 Sep 06:14

Choose a tag to compare

  • Fixed: Added UseHangfireJobScheduler() and marked UseHandfireJobScheduler()
    obsolete, fixing method spelling mistake

v0.14.1051

23 Sep 19:07

Choose a tag to compare

  • Breaking: All EventFlowOptions extensions are now IEventFlowOptions
    instead and EventFlowOptions implements this interface. If you have made
    your own extensions, you will need to use the newly created interface
    instead. Changed in order to make testing of extensions and classes
    dependent on the EventFlow options easier to test
  • New: You can now bundle your configuration of EventFlow into modules that
    implement IModule and register these by calling
    EventFlowOptions.RegisterModule(...)
  • New: EventFlow now supports scheduled job execution via e.g. Hangfire. You
    can create your own scheduler or install the new EventFlow.Hangfire NuGet
    package. Read the jobs documentation for more details
  • New: Created the OWIN CommandPublishMiddleware middleware that can
    handle publishing of commands by posting a JSON serialized command to
    e.g. /commands/ping/1 in which ping is the command name and 1 its
    version. Remember to add authentication
  • New: Created a new interface ICommand<TAggregate,TIdentity,TSourceIdentity>
    to allow developers to control the type of ICommand.SourceId. Using the
    ICommand<TAggregate,TIdentity> (or Command<TAggregate,TIdentity>)
    will still yield the same result as before, i.e., ICommand.SourceId being
    of type ISourceId
  • New: The AddDefaults(...) now also adds the command type definition to the
    new ICommandDefinitonService

v0.13.962

13 Sep 20:16

Choose a tag to compare

  • Breaking: EventFlowOptions.AddDefaults(...) now also adds query handlers
  • New: Added an optional Predicate<Type> to the following option extension
    methods that scan an Assembly: AddAggregateRoots(...),
    AddCommandHandlers(...), AddDefaults(...), AddEventUpgraders(...),
    AddEvents(...), AddMetadataProviders(...), AddQueryHandlers(...) and
    AddSubscribers(...)
  • Fixed: EventFlowOptions.AddAggregateRoots(...) now prevents abstract
    classes from being registered when passing IEnumerable<Type>
  • Fixed: Events published to RabbitMQ are now in the right order for chains
    of subscribers, if event A -> subscriber -> command -> aggregate -> event B,
    then the order of published events to RabbitMQ was event B and then
    event A

v0.12.891

04 Sep 21:12

Choose a tag to compare

  • Breaking: Aggregate root no longer have Aggregate removed from their
    when name, i.e., the metadata property with key aggregate_name (or
    MetadataKeys.AggregateName). If you are dependent on the previous naming,
    use the new AggregateName attribute and apply it to your aggregates
  • Breaking: Moved Identity<> and IIdentity from the EventFlow.Aggregates
    namespace to EventFlow.Core as the identities are not specific for aggregates
  • Breaking: ICommand.Id is renamed to ICommand.AggregateId to make "room"
    for the new ICommand.SourceId property. If commands are serialized, then
    it might be important verify that the serialization still works. EventFlow
    does not serialize commands, so no mitigation is provided. If the
    Command<,> is used, make sure to use the correct protected constructor
  • Breaking: IEventStore.StoreAsync(...) now requires an additional
    ISourceId argument. To create a random one, use SourceId.New, but it
    should be e.g. the command ID that resulted in the events. Note, this method
    isn't typically used by developers
  • New: Added ICommand.SourceId, which contains the ID of the source. The
    default (if your commands inherit from Command<,>) will be a new
    CommandId each time the a Command<,> instance is created. You can pass
    specific value, merely use the newly added constructor taking the ID.
    Alternatively you commands could inherit from the new
    DistinctCommand, enabling commands with the same state to have the
    same SourceId
  • New: Duplicate commands can be detected using the new ISourceId. Read the
    EventFlow article regarding commands for more details
  • New: Aggregate names can now be configured using the attribute
    AggregateName. The name can be accessed using the new IAggregateRoot.Name
    property
  • New: Added Identity<>.NewDeterministic(Guid, string) enabling creation of
    deterministic GUIDs
  • New: Added new metadata key source_id (MetadataKeys.SourceId) containing
    the source ID, typically the ID of the command from which the event
    originated
  • New: Added new metadata key event_id (MetadataKeys.EventId) containing a
    deterministic ID for the event. Events with the same aggregate sequence
    number and from aggregates with the same identity, will have the same event
    identity
  • Fixed: Identity<>.With(string) now throws an ArgumentException instead of
    a TargetInvocationException when passed an invalid identity
  • Fixed: Aggregate roots now build the cache of Apply methods once, instead
    of when the method is requested the first time

v0.11.751

24 Aug 20:36

Choose a tag to compare

  • Breaking: EventFlowOptions.AddDefaults(...) now also adds event
    definitions
  • New: RabbitMQ is now supported through the new
    NuGet package called EventFlow.RabbitMQ which enables domain events to be
    published to the bus
  • New: If you want to subscribe to all domain events, you can implement
    and register a service that implements ISubscribeSynchronousToAll. Services
    that implement this will automatically be added using the
    AddSubscribers(...) or AddDefaults(...) extension to EventFlowOptions
  • New: Use EventFlowOptions.UseAutofacAggregateRootFactory(...) to use an
    Autofac aggregate root factory, enabling you to use services in your
    aggregate root constructor
  • New: Use EventFlowOptions.UseResolverAggregateRootFactory() to use the
    resolver to create aggregate roots. Same as
    UseAutofacAggregateRootFactory(...) but for when using the internal IoC
    container
  • New: Use EventFlowOptions.AddAggregateRoots(...) to register aggregate root
    types
  • New: Use IServiceRegistration.RegisterType(...) to register services by
    type

v0.10.642

17 Aug 05:07

Choose a tag to compare

  • Breaking: Updated NuGet reference Newtonsoft.Json to v7.0.1
    (up from v6.0.8)
  • Breaking: Remove the empty constructor from SingleValueObject<>
  • New: Added SingleValueObjectConverter to help create clean JSON when
    e.g. domain events are serialized
  • New: Added a protected method Register(IEventApplier) to
    AggregateRoot<,> that enables developers to override how events are
    applied. Use this to e.g. implement state objects
  • New: Create AggregateState<,,> that developers can use to create aggregate
    state objects. Call Register(...) with the state object as argument
    to redirect events to it
  • New: Allow AggregateRoot<,>.Apply(...), i.e., methods for applying events,
    to be private and protected
  • New: Made AggregateRoot<,>.Emit(...) protected and virtual to allow
    overrides that e.g. add a standard set of metadata from the aggregate state.
  • New: Made AggregateRoot<,>.ApplyEvent(...) protected and virtual to
    allow more custom implementations of applying events to the aggregate root.
  • Fixed: Updated internal NuGet reference Dapper to v1.42 (up from v1.38)

v0.9.580

20 Jul 06:43

Choose a tag to compare

  • Braking: IEventStore.LoadAllEventsAsync and IEventStore.LoadAllEvents
    now take a GlobalPosition as an argument instead of a long for the
    starting position. The GlobalPosition is basically a wrapper around a
    string that hides the inner workings of each event store.
  • New: NuGet package EventFlow.EventStores.EventStore that provides
    integration to Event Store. Its an initial
    version and shouldn't be used in production.

v0.8.560

29 May 05:23

Choose a tag to compare

  • Breaking: Remove all functionality related to global sequence
    numbers as it proved problematic to maintain. It also matches this
    quote:

    Order is only assured per a handler within an aggregate root
    boundary. There is no assurance of order between handlers or
    between aggregates. Trying to provide those things leads to
    the dark side.

    Greg Young

    • If you use a MSSQL read store, be sure to delete the
      LastGlobalSequenceNumber column during update, or set it to
      default NULL
    • IDomainEvent.GlobalSequenceNumber removed
    • IEventStore.LoadEventsAsync and IEventStore.LoadEvents taking
      a GlobalSequenceNumberRange removed
  • Breaking: Remove the concept of event caches. If you really need this
    then implement it by registering a decorator for IEventStore

  • Breaking: Moved IDomainEvent.BatchId to metadata and created
    MetadataKeys.BatchId to help access it

  • New: IEventStore.DeleteAggregateAsync to delete an entire aggregate
    stream. Please consider carefully if you really want to use it. Storage
    might be cheaper than the historic knowledge within your events

  • New: IReadModelPopulator is new and enables you to both purge and
    populate read models by going though the entire event store. Currently
    its only basic functionality, but more will be added

  • New: IEventStore now has LoadAllEventsAsync and LoadAllEvents that
    enables you to load all events in the event store a few at a time.

  • New: IMetadata.TimestampEpoch contains the Unix timestamp version
    of IMetadata.Timestamp. Also, an additional metadata key
    timestamp_epoch is added to events containing the same data. Note,
    the TimestampEpoch on IMetadata handles cases in which the
    timestamp_epoch is not present by using the existing timestamp

  • Fixed: AggregateRoot<> now reads the aggregate version from
    domain events applied during aggregate load. This resolves an issue
    for when an IEventUpgrader removed events from the event stream

  • Fixed: InMemoryReadModelStore<,> is now thread safe