Skip to content

Releases: eventflow/EventFlow

v0.20.1274

22 Oct 05:03
Compare
Choose a tag to compare
  • Breaking: Entity<T> now inherits from ValueObject but uses only the Id
    field as equality component. Override GetEqualityComponents() if you have
    a different notion of equality for a specific entity
  • Breaking: Entity<T> will now throw an ArgumentNullException if the id
    passed to its constructor is null
  • Breaking: Fixed method spelling. Renamed
    ISpecification<T>.WhyIsNotStatisfiedBy to WhyIsNotSatisfiedBy and
    Specification<T>.IsNotStatisfiedBecause to IsNotSatisfiedBecause
  • New: Read model support for Elasticsearch via the new NuGet package
    EventFlow.ReadStores.Elasticsearch

v0.19.1225

19 Oct 17:32
Compare
Choose a tag to compare
  • Breaking: AddDefaults now also adds the job type definition to the
    IJobsDefinitonService
  • New: Implemented a basic specification pattern by providing
    ISpecification<T>, an easy-to-use Specificaion<T> and a set of extension
    methods. Look at the EventFlow specification tests to get started
  • Fixed: IEventDefinitionService, ICommandDefinitonService and
    IJobsDefinitonService now longer throw an exception if an existing
    event is loaded, i.e., multiple calls to AddEvents(...), AddCommand(...)
    and AddJobs(...) no longer throws an exception
  • Fixed: DomainError.With(...) no longer executes string.format if only
    one argument is parsed

v0.18.1181

07 Oct 19:15
Compare
Choose a tag to compare
  • POTENTIAL DATA LOSS for the files event store: The EventFlow
    internal functionality regarding event stores has been refactored resulting
    in information regarding aggregate names being removed from the event
    persistence layer. The files based event store no longer stores its events in
    the path [STORE PATH]\[AGGREGATE NAME]\[AGGREGATE ID]\[SEQUENCE].json, but
    in the path [STORE PATH]\[AGGREGATE ID]\[SEQUENCE].json. Thus if you are
    using the files event store for tests, you should move the events into the
    new file structure. Alternatively, implement the new IFilesEventLocator and
    provide your own custom event file layout.
  • Breaking: Event stores have been split into two parts, the IEventStore
    and the new IEventPersistence. IEventStore has the same interface before
    but the implementation is now no longer responsible for persisting the events,
    only converting and serializing the persisted events. IEventPersistence
    handles the actual storing of events and thus if any custom event stores have
    been implemented, they should implement to the new IEventPersistence
    instead.
  • New: Added IEntity, IEntity<> and an optional Entity<> that developers
    can use to implement DDD entities.

v0.17.1134

28 Sep 11:32
Compare
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
Compare
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
Compare
Choose a tag to compare
  • Fixed: Added UseHangfireJobScheduler() and marked UseHandfireJobScheduler()
    obsolete, fixing method spelling mistake

v0.14.1051

23 Sep 19:07
Compare
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
Compare
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
Compare
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
Compare
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