Dolittle.SDK.EventHorizon 23.5.0

dotnet add package Dolittle.SDK.EventHorizon --version 23.5.0                
NuGet\Install-Package Dolittle.SDK.EventHorizon -Version 23.5.0                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Dolittle.SDK.EventHorizon" Version="23.5.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Dolittle.SDK.EventHorizon --version 23.5.0                
#r "nuget: Dolittle.SDK.EventHorizon, 23.5.0"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Dolittle.SDK.EventHorizon as a Cake Addin
#addin nuget:?package=Dolittle.SDK.EventHorizon&version=23.5.0

// Install Dolittle.SDK.EventHorizon as a Cake Tool
#tool nuget:?package=Dolittle.SDK.EventHorizon&version=23.5.0                

Dolittle

Dolittle is a decentralized, distributed, event-driven microservice platform built to harness the power of events.

This is our C# SDK, install it with:

dotnet add package Dolittle.SDK 

Get Started

Want to try another language?

Issues and Contributing

Issues and contributions are always welcome!

To learn how to contribute, please read our contributing guide.

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on Dolittle.SDK.EventHorizon:

Package Downloads
Dolittle.SDK

Dolittle is a decentralized, distributed, event-driven microservice platform built to harness the power of events.

Dolittle.Applications.EventHorizon

Dolittle is a platform designed to build Line of Business applications without sacrificing architectural quality, code quality or scalability.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
23.5.0 162 10/23/2024
23.4.0 366 10/2/2024
23.3.0 485 7/31/2024
23.2.5 582 6/20/2024
23.2.4 211 6/13/2024
23.2.3 142 6/10/2024
23.2.2 171 6/2/2024
23.2.1 173 5/16/2024
23.2.0 1,267 3/14/2024
23.1.0 201 3/12/2024
23.0.0 185 3/8/2024
22.1.3 261 2/26/2024
22.1.2 1,097 10/24/2023
22.1.1 299 10/4/2023
22.1.0 229 9/18/2023
22.0.5 284 9/7/2023
22.0.4 353 8/28/2023
22.0.3 311 8/15/2023
22.0.2 273 8/8/2023
22.0.1 222 8/8/2023
22.0.0 450 6/22/2023
22.0.0-arkenstone.1 86 6/21/2023
22.0.0-arkenstone.0 75 6/12/2023
21.0.2 436 9/7/2023
21.0.1 610 6/8/2023
21.0.0 284 6/2/2023
21.0.0-feanor.2 78 5/31/2023
21.0.0-feanor.1 1,150 5/30/2023
21.0.0-feanor.0 75 5/30/2023
20.2.0 2,476 1/23/2023
20.2.0-shire.17 112 1/19/2023
20.2.0-shire.16 110 1/16/2023
20.2.0-shire.15 116 1/12/2023
20.2.0-shire.14 108 1/12/2023
20.2.0-shire.13 112 1/12/2023
20.2.0-shire.12 107 1/11/2023
20.2.0-shire.11 96 1/10/2023
20.2.0-shire.10 107 1/6/2023
20.2.0-shire.9 112 1/6/2023
20.2.0-shire.8 116 1/6/2023
20.2.0-shire.7 106 1/6/2023
20.2.0-shire.6 119 1/5/2023
20.2.0-shire.5 112 1/5/2023
20.2.0-shire.4 111 1/5/2023
20.2.0-shire.3 113 1/5/2023
20.2.0-shire.2 115 12/26/2022
20.2.0-shire.1 106 12/26/2022
20.2.0-shire.0 105 12/26/2022
20.1.0 465 12/25/2022
20.1.0-faramir.1 102 12/12/2022
20.1.0-faramir.0 97 12/9/2022
20.0.2 1,120 12/13/2022
20.0.1 415 12/12/2022
20.0.0 444 12/8/2022
19.1.0-elrond.7 101 12/7/2022
19.1.0-elrond.6 101 12/5/2022
19.1.0-elrond.5 93 12/5/2022
19.1.0-elrond.4 93 12/2/2022
19.1.0-elrond.3 101 12/2/2022
19.1.0-elrond.2 94 11/29/2022
19.1.0-elrond.1 97 11/28/2022
19.1.0-elrond.0 104 11/28/2022
19.0.0 695 11/25/2022
19.0.0-proto.5 91 11/25/2022
19.0.0-proto.4 117 11/22/2022
19.0.0-proto.3 106 11/21/2022
19.0.0-proto.2 96 11/21/2022
19.0.0-proto.1 109 11/21/2022
19.0.0-proto.0 105 11/18/2022
18.2.0-bolt.1 92 11/16/2022
18.2.0-bolt.0 114 11/16/2022
18.1.1 929 10/31/2022
18.1.0 901 10/26/2022
18.0.1 945 10/20/2022
18.0.0 985 9/15/2022
17.2.3 1,012 9/9/2022
17.2.2 1,595 8/26/2022
17.2.1 1,814 8/10/2022
17.2.0 1,117 7/8/2022
17.1.2 1,039 7/7/2022
17.1.1 1,004 7/7/2022
17.1.0 995 7/5/2022
17.1.0-boromir.4 121 7/8/2022
17.1.0-boromir.3 111 7/5/2022
17.1.0-boromir.2 119 7/1/2022
17.1.0-boromir.1 113 7/1/2022
17.0.2 1,490 6/21/2022
17.0.0 4,179 3/25/2022
17.0.0-meriadoc.0 123 3/24/2022
16.0.1 1,033 3/22/2022
16.0.0 1,032 3/14/2022
15.1.3 1,042 3/8/2022
15.1.2 1,034 3/1/2022
15.1.1 1,027 2/11/2022
15.1.0 1,028 2/11/2022
15.0.1 1,189 2/10/2022
15.0.0 996 2/10/2022
14.2.0 1,032 2/9/2022
14.2.0-sam.2 132 2/9/2022
14.2.0-sam.1 123 2/7/2022
14.2.0-sam.0 125 2/7/2022
14.1.0 1,028 1/28/2022
14.0.0 1,050 1/25/2022
14.0.0-gollum.1 129 1/25/2022
14.0.0-gollum.0 141 1/24/2022
13.1.0-bilbo.4 131 1/24/2022
13.1.0-bilbo.3 142 1/24/2022
13.1.0-bilbo.2 125 1/21/2022
13.1.0-bilbo.1 129 1/21/2022
13.1.0-bilbo.0 135 1/21/2022
13.0.1 1,062 1/24/2022
13.0.0 1,048 1/20/2022
13.0.0-gimli.10 125 1/20/2022
13.0.0-gimli.9 174 1/19/2022
13.0.0-gimli.8 129 1/19/2022
13.0.0-gimli.7 125 1/18/2022
13.0.0-gimli.6 128 1/17/2022
13.0.0-gimli.5 132 1/17/2022
13.0.0-gimli.4 134 1/17/2022
13.0.0-gimli.3 155 12/7/2021
13.0.0-gimli.2 184 12/7/2021
13.0.0-gimli.1 168 12/7/2021
13.0.0-gimli.0 860 12/1/2021
12.1.0-gandalf.0 1,476 11/26/2021
12.0.0 689 11/18/2021
12.0.0-legolas.7 140 11/18/2021
12.0.0-legolas.6 147 11/16/2021
12.0.0-legolas.5 141 11/15/2021
12.0.0-legolas.4 137 11/15/2021
12.0.0-legolas.3 166 11/11/2021
12.0.0-legolas.2 151 11/10/2021
12.0.0-legolas.1 160 11/9/2021
12.0.0-legolas.0 147 11/9/2021
11.0.0 7,075 11/5/2021
11.0.0-aragorn.8 168 11/5/2021
11.0.0-aragorn.7 178 11/4/2021
11.0.0-aragorn.6 146 11/4/2021
11.0.0-aragorn.5 165 11/4/2021
11.0.0-aragorn.4 163 11/2/2021
11.0.0-aragorn.3 165 11/2/2021
11.0.0-aragorn.2 168 10/29/2021
11.0.0-aragorn.1 146 10/26/2021
11.0.0-aragorn.0 196 10/25/2021
10.1.0 776 10/21/2021
10.0.0 605 10/13/2021
10.0.0-eventsource.1 149 10/13/2021
10.0.0-eventsource.0 140 10/5/2021
9.2.0 6,195 9/29/2021
9.2.0-register-all.1 154 9/15/2021
9.2.0-register-all.0 146 9/7/2021
9.1.1 1,851 12/21/2021
9.1.0 4,694 7/14/2021
9.1.0-embeddings.0 155 7/5/2021
9.0.0 752 6/16/2021
8.5.0-timeout.4 1,365 6/4/2021
8.5.0-timeout.3 159 6/4/2021
8.5.0-timeout.2 213 5/31/2021
8.5.0-timeout.1 321 5/30/2021
8.5.0-timeout.0 235 5/29/2021
8.4.0 3,892 4/9/2021
8.4.0-projections.2 174 4/9/2021
8.4.0-projections.1 168 4/7/2021
8.4.0-projections.0 166 4/7/2021
8.3.2 2,165 3/24/2021
8.3.1 778 2/22/2021
8.3.0 655 2/17/2021
8.2.0 646 2/17/2021
8.1.1 635 2/14/2021
8.1.0 666 2/14/2021
8.1.0-updatedeps.0 209 1/20/2021
8.0.0 2,689 11/2/2020
7.0.0 839 10/28/2020
7.0.0-redpill.1 286 10/14/2020
7.0.0-redpill.0 346 10/13/2020
6.0.0 817 10/2/2020
6.0.0-rc.21 216 10/2/2020
6.0.0-rc.20 224 10/1/2020
6.0.0-rc.19 217 9/30/2020
6.0.0-rc.18 243 9/30/2020
6.0.0-rc.17 226 9/30/2020
6.0.0-rc.16 224 9/30/2020
6.0.0-rc.15 249 9/28/2020
6.0.0-rc.14 229 9/25/2020
6.0.0-rc.13 235 9/25/2020
6.0.0-rc.12 219 9/25/2020
6.0.0-rc.11 235 9/22/2020
6.0.0-rc.10 229 9/21/2020
6.0.0-rc.9 243 9/18/2020
6.0.0-rc.8 223 9/18/2020
6.0.0-rc.7 277 9/16/2020
6.0.0-rc.6 296 9/16/2020
6.0.0-rc.5 238 9/15/2020
6.0.0-rc.4 241 9/11/2020
6.0.0-rc.3 252 9/11/2020
6.0.0-rc.2 249 9/8/2020
6.0.0-rc.1 232 8/26/2020
5.0.0 3,124 7/7/2020
5.0.0-rc.8 257 7/7/2020
5.0.0-rc.7 379 6/26/2020
5.0.0-rc.6 284 6/15/2020
5.0.0-rc.5 533 6/11/2020
5.0.0-rc.4 251 6/11/2020
5.0.0-rc.3 292 5/29/2020
5.0.0-rc.2 278 5/25/2020
5.0.0-alpha.32 266 5/22/2020
5.0.0-alpha.31 245 5/14/2020
5.0.0-alpha.30 848 4/16/2020
5.0.0-alpha.29 239 4/16/2020
5.0.0-alpha.28 239 4/15/2020
5.0.0-alpha.27 233 4/15/2020
5.0.0-alpha.26 239 4/14/2020
5.0.0-alpha.25 292 4/7/2020
5.0.0-alpha.24 485 3/25/2020
5.0.0-alpha.23 280 3/25/2020
5.0.0-alpha.22 263 3/25/2020
5.0.0-alpha.21 344 3/23/2020
5.0.0-alpha.20 332 3/23/2020
5.0.0-alpha.19 275 3/19/2020
5.0.0-alpha.18 254 3/19/2020
5.0.0-alpha.17 302 3/18/2020
5.0.0-alpha.16 262 3/18/2020
5.0.0-alpha.15 279 3/18/2020

Version 23.5.0:
This adds support for retroactively redacting personal data details from previously committed events. Redactions are scoped to a single EventSourceId, and a single event type, and allow you to overwrite or remove specific fields.

How to use it:
Events that should be redacted must be annotated to target the fields that should be updated or removed

[EventType("24e3a119-57d5-45d7-b7ef-a736fe6331e7")]
public class CustomerRegistered
{
   // The generic type will replace the value
   [RedactablePersonalData<string>("<redacted>")]
   public string Name { get; init; }
   
   //  The non-generic one will remove the field altogether
   [RedactablePersonalData]
   public Address? CustomerAddress { get; init; }
}They can then be redacted by committing a targeted redaction event on the same eventsourceId as the redacted events.

It can either be done with the built-in event

   public void GdprForget(string reason, string performedBy)
   {
       Apply(Redactions.Create<CustomerRegistered>(reason, performedBy));
   }or a user-created event

[EventType("de1e7e17-bad5-da7a-a4f7-e409ae1785dc")]
public class CustomerDetailsForgotten : PersonalDataRedactedForEvent<CustomerRegistered>
{
}Applied like this

   public void GdprForget(string reason, string performedBy)
   {
       Apply(Redactions.Create<CustomerRegistered, CustomerDetailsForgotten>(reason, performedBy));
   }What about read models and aggregate state ?:
Aggregates and read models should handle the redactions as normal events, and update state accordingly.

Ex

   public void On(CustomerDetailsForgotten evt)
   {
       _address = null;
       _name = null;
       _gdprRedacted = true;
   }Read models are not automagically updated, but should handle the redaction events themselves. Redaction events after being committed behave exactly as any other event, and can be processed by both eventhandlers and projections.

Since you would want the eventhandlers to only handle as few events as needed, user defined redaction events are the suggested way to perform redactions.

How does it work?:
The runtime will recognize the redaction event type with the redaction prefix "de1e7e17-bad5-da7a", and if the events have the correctly formatted structure, it will perform the redactions in the same transaction as the new events are being added.

It will replace overridden properties as specified in RedactedProperties, and remove properties that are defined with null values.

Redaction events themselves cannot be redacted, to ensure auditability of the system.

Added:
- Dolittle.SDK.Events.Redaction.PersonalDataRedactedForEvent - Built in event that can redact any event type
- Dolittle.SDK.Events.Redaction.PersonalDataRedactedForEvent<TEvent> - Class to extend in order to create redactions for specific events
- Dolittle.SDK.Events.Redaction - Use this to simplify creation of redaction events

Updated:
- The solution was updated to use centralized package management (https://learn.microsoft.com/en-us/nuget/consume-packages/Central-Package-Management) to simplify dependency maintenance. Dependencies have also been upgraded.

Changelog:
For all release notes, see changelog (https://github.com/dolittle/DotNET.SDK/blob/master/CHANGELOG.md)