Kephas.Messaging 11.1.0 The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org. Prefix Reserved

.NET 6.0 .NET Standard 2.1
Install-Package Kephas.Messaging -Version 11.1.0
dotnet add package Kephas.Messaging --version 11.1.0
<PackageReference Include="Kephas.Messaging" Version="11.1.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Kephas.Messaging --version 11.1.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Kephas.Messaging, 11.1.0"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install Kephas.Messaging as a Cake Addin
#addin nuget:?package=Kephas.Messaging&version=11.1.0

// Install Kephas.Messaging as a Cake Tool
#tool nuget:?package=Kephas.Messaging&version=11.1.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Messaging

Application components and services are just pieces in a big puzzle, requiring in most cases to interact and communicate. The simplest interaction is when inside a component the counterpart is identified, either directly or by the means of [[dependency injection|Composition and Dependency Injection]], and the required API method is called. This implies that the consumer knows which provider handles the message and that both components, consumer and provider, live in the same process.

The messaging infrastructure Kephas provides addresses these key issues:

  • The communication may be performed among loosely coupled components. The components communicate through the means of a message, not knowing about each other, not being necessarily in the same process.
  • Two kinds of patterns are supported by default:
    • Request/Response: The requester send a message to be processed and awaits for the response.
    • Publisher/Subscriber: The publisher emits an event for which subscribers are notified when it occurs.
  • The infrastructure may be extended to support other types of patterns, as needed.

To anticipate a little bit, using the messaging infrastructure is as simple as that:

    var message = new PingMessage();
    var pingBack = await messageProcessor.ProcessAsync(message).PreserveThreadContext();
    var serverTime = pingBack.ServerTime;

So, there is no information whatsoever about who processes the message, only the message processor taking the responsibility of carrying this to a good end.

Messages

The message is the content of communication. A message:

  • implements IMessage. This is only a marker interface so that messages may be identified as such and no other kind of objects are communicated.
  • is serializable. This is somehow natural, as the communication may happen inter-processes and even across machines.

Strongly typed and weakly typed messages

The message type plays an important role, as it is used to filter message handlers (more about this in the [[message handlers|Architecture-of-messaging#Message handlers]] section. However, there are so called weakly typed messages, which hold actually a category of messages that for some reason cannot be strongly typed, typically used in distributed scenarios and coming from external sources. These weakly typed messages will provide a name, used for discriminating the message handlers, retrieved as:

  • the MessageName property of the message class -or-
  • the dynamic MessageName property in the case of a dynamic message object.

Events

Events are a special case of messages targeting the Publisher/Subscriber pattern. An event:

  • implements IEvent. This is also a marker interface inheriting from IMessage.

Message handlers

A message handler is an [[application service|Application Services]] processing a message of a given type and, optionally, name.

  • implements the IMessageHandler<TMessage> application service contract.
  • provides the ProcessAsync method where the message handling takes place.
    • ProcessAsync(message: TMessage, context: IMessageProcessingContext, token: CancellationToken): Task<IMessage>
  • (optionally) is annotated with the [MessageName] attribute, to indicate the name of the handled message in case of weakly typed messages.

Typically, a message handler specializes the MessageHandlerBase<TMessage, TResponseMessage> base class, which takes care of basic message type checks and provides an overridable typed ProcessAsync method.

Note: message handlers are NOT singleton application services. This is by design, so that any resources hold during the message processing can be disposed freely at the end. Therefore they can be safely implemented as statefull.

It is the sole responsibility of the message processor to make sure that the handler receives the appropriate messages which it is registered for. The message handler assumes it receives only messages of the declared type and name.

The message processor

The service taking care of message processing is the message processor. It is a [[singleton application service|Application-Services#shared-scope-shared-or-instance-based-services]] which is in charge of selecting the appropriate handler (or handlers) for a particular message, ensuring that that (or those) handlers handle the message, and returning a response. It provides a single method:

  • ProcessAsync(message: IMessage, [context: IMessageProcessingContext], [token: CancellationToken]): Task<IMessage>
    • message: the message to process.
    • context: contextual information related to the particular call. If no processing context is provided, a default one will be created. The processor ensures that the context contains the processor itself, the original message to be processed, and the handler which is at that moment handling the message. This information may be useful in the [[processing behaviors|Architecture-of-messaging#Processing behaviors]], as described in the following sections.

Kephas provides a default implementation, see the [[default message processor|In-Process-messaging#the-defaultmessageprocessor]] for more information about it.

Handler selectors

The typical message bus implementations do not filter the message handlers, leaving them the responsibility of handling or not handling a particular message. In Kephas, this responsibility is delegated to the handler selectors, which decide if and how the handlers are filtered before letting them handle a message. They provide two methods for interaction with the message processor:

  • CanHandle(messageType: Type, messageName: string): boolean: Indicates whether the selector can handle the indicated message type. This is the method by which the selectors are requested to indicate whether they are in charge of providing the handlers for a specific message type and name.
  • GetHandlersFactory(messageType: Type, messageName: string): Func<IEnumerable<IMessageHandler>>: Gets a factory which retrieves the components handling messages of the given type.

EventMessageHandlerSelector

This is a handler selector for [[events|Architecture-of-messaging#Events]]. It returns all the handlers processing the specific event type and name, ordered by their processing priority.

Note: it has the Low processing priority, so that custom code can modify easily the strategy of selecting event handlers.

DefaultMessageHandlerSelector

This is the fallback handler selector for generic messages. It returns a single handler processing the specific message type and name, in the order of override and processing priority. If two or more handlers have the same override and processing priority, an AmbiguousMetchException occurs.

Note: this selector has the lowest processing priority, being the fallback for messages not handled by any other selector.

Processing behaviors

The processing of a message may be intercepted be message processing behaviors, before and after the actual handler invocation. They can do various things, like auditing, authorization checking, or whatever other functionality may be needed. Behaviors are [[singleton application services|Application-Services#shared-scope-shared-or-instance-based-services]], so they should no store any processing information, but use exclusively the processing context for such scenarios. They implement the contract IMessageProcessingBehavior which provides two methods:

  • BeforeProcessAsync(context: IMessageProcessingContext, token: CancellationToken): Task: Interception called before invoking the handler to process the message.
  • AfterProcessAsync(context: IMessageProcessingContext, token: CancellationToken): Task: Interception called after invoking the handler to process the message.

In-process messaging flow

In-Process Messaging

The DefaultMessageProcessor

Kephas provides the DefaultMessageProcessor class, a [[low override priority|Application-Services#override-priority]] message processor. It provides a basic, overridable functionality for processing messages, which should be enough for most cases.

  • It aggregates [[message handler selectors|Architecture-of-messaging#Handler selectors]] and calls them to provide a list of message handlers to process a particular message, in their [[processing priority|Application-Services#processing-priority]] order.
  • It aggregates [[processing filters|Architecture-of-messaging#Processing filters]] and calls them before and after each handler's ProcessAsync call.

Note that the message processor is an in-process service. However, if the handlers themselves go beyond the process boundary it is their sole responsibility and, at the same time, freedom.

The flow of the ProcessAsync implementation is as follows:

  • Resolve the processing filters, ordered by their processing priority.
  • Resolve the handlers, as provided by the handler selectors called in their processing priority order.
    • Question the selectors in the indicated order whether they can provide handlers for the message.
    • The first selector answering with true is delegated to provide the handlers, the rest are ignored.
  • Call each handler to process the message, awaiting for their response.
    • Before calling the handler, the ordered filters are invoked.
    • After calling the handler, the filters are invoked in the inverse order.
  • Returns the response of the last called handler.

Note: if the handler throws an exception, the processing filters are called in the after method. with the exception information set in the context. However, if a filter throws an exception during the processing, it interrupts the flow and the exception is thrown to the caller. This is by design, so that, for example, authorization filters are able to interrupt the processing flow.

Securing the messaging infrastructure

The responsibility of the message processor during execution is to ensure that the provided message gets handled by one or more handlers, and that the behaviors are properly called; however it remains agnostic to the semantics of the message itself. The authorization check is ensured by behaviors:

  • EnsureAuthorizedMessageProcessingBehavior takes the job of ensuring that the handling of the message is authorized.
    • Retrieves the required permissions as specified at message level.
    • Identifies the authorization scope by invoking the [[authorization scope service]].
    • Invokes the [[authorization service]] to authorize the scope for the required permissions.

Securing messages

Messages may be secured by decorating them with the [RequiresPermission] attribute.

Example:

    /// <summary>
    /// Message for importing a hierarchy node.
    /// </summary>
    [RequiresPermission(typeof(IExportImportPermission))]
    public class ImportHierarchyMessage : EntityActionMessage
    {
        // ...
    }
Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows
.NET Core netcoreapp3.0 netcoreapp3.1
.NET Standard netstandard2.1
MonoAndroid monoandroid
MonoMac monomac
MonoTouch monotouch
Tizen tizen60
Xamarin.iOS xamarinios
Xamarin.Mac xamarinmac
Xamarin.TVOS xamarintvos
Xamarin.WatchOS xamarinwatchos
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (13)

Showing the top 5 NuGet packages that depend on Kephas.Messaging:

Package Downloads
Kephas.Messaging.Model The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Provides a modeling API framework for messaging. Provides the model for messaging, including the Message classifier and Messaging scope dimension. Typically used areas and classes/interfaces/services: - IMessageType. - Dimensions: Messaging (area). - AttributedModel: MessagePartAttribute. Kephas Framework ("stone" in aramaic) aims to deliver a solid infrastructure for applications and application ecosystems.

Kephas.Data.Endpoints The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Adds messaging endpoints for data services. The endpoints will work if Kephas.Messaging is referenced and the IMessageProcessor is used for processing the messages. Typically used areas and classes/interfaces/services: - PersistChangesHandler, QueryHandler, DataSourceHandler. Kephas Framework ("stone" in aramaic) aims to deliver a solid infrastructure for applications and application ecosystems.

Kephas.Orchestration The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Provides the infrastructure for orchestrating microservices based on the Kephas Framework. Typically used areas and classes/interfaces/services: - IOrchestrationManager, IRuntimeAppInfo. - Interaction: AppHeartbeatEvent, AppStartedEvent, AppStoppedEvent. - Endpoints: StopAppMessage. Kephas Framework ("stone" in aramaic) aims to deliver a solid infrastructure for applications and application ecosystems.

Kephas.Plugins.Endpoints The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Adds messaging endpoints for managing plugins. The endpoints will work if Kephas.Messaging is referenced and the IMessageProcessor is used for processing the messages. Typically used areas and classes/interfaces/services: - Install/Uninstall/UpdatePluginHandler, Enable/DisablePluginHandler, GetAvailablePluginsHandler, GetInstalledPluginsHandler. Kephas Framework ("stone" in aramaic) aims to deliver a solid infrastructure for applications and application ecosystems.

Kephas.Core.Endpoints The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Adds messaging endpoints for core services. The endpoints wills work if Kephas.Messaging is referenced and the IMessageProcessor is used for processing the messages. Typically used areas and classes/interfaces/services: - EncryptMessage, HashMessage, GetLogLevelMessage, SetLogLevelMessage. Kephas Framework ("stone" in aramaic) aims to deliver a solid infrastructure for applications and application ecosystems.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
11.1.0 194 4/13/2022
11.1.0-dev.4 56 4/6/2022
11.1.0-dev.3 48 3/30/2022
11.1.0-dev.2 48 3/23/2022
11.1.0-dev.1 42 3/23/2022
11.0.0 189 3/11/2022
11.0.0-dev.7 57 3/7/2022
11.0.0-dev.6 47 2/28/2022
11.0.0-dev.5 45 2/26/2022
11.0.0-dev.4 49 2/24/2022
11.0.0-dev.3 47 2/23/2022
11.0.0-dev.2 47 2/18/2022
11.0.0-dev.1 50 2/7/2022
10.3.0 143 1/18/2022
10.2.0 855 12/3/2021
10.1.0 4,897 11/23/2021
10.1.0-dev.7 114 11/17/2021
10.1.0-dev.6 90 11/16/2021
10.1.0-dev.5 91 11/10/2021
10.1.0-dev.4 106 11/8/2021
10.1.0-dev.3 75 11/8/2021
10.1.0-dev.2 90 11/4/2021
10.1.0-dev.1 81 11/3/2021
10.0.1 706 10/16/2021
10.0.0 737 10/13/2021
10.0.0-dev.4 77 10/13/2021
10.0.0-dev.3 96 10/11/2021
10.0.0-dev.2 145 10/8/2021
9.3.4 610 8/25/2021
9.3.3 628 8/25/2021
9.3.2 617 8/24/2021
9.3.1 619 8/12/2021
9.3.0 624 8/12/2021
9.2.0 692 6/17/2021
9.1.0 702 6/17/2021
9.1.0-dev.9 109 5/26/2021
9.1.0-dev.8 100 5/26/2021
9.1.0-dev.7 101 5/17/2021
9.1.0-dev.6 101 4/28/2021
9.1.0-dev.5 109 4/23/2021
9.1.0-dev.4 107 4/21/2021
9.1.0-dev.3 105 4/17/2021
9.1.0-dev.2 110 4/12/2021
9.1.0-dev.1 109 4/9/2021
9.0.5 661 3/31/2021
9.0.4 705 3/23/2021
9.0.3 689 3/20/2021
9.0.1 643 3/18/2021
9.0.0 695 3/17/2021
9.0.0-dev.4 102 3/4/2021
9.0.0-dev.3 112 3/1/2021
9.0.0-dev.2 129 2/22/2021
8.4.0 1,121 11/11/2020
8.3.0 814 10/28/2020
8.2.0 941 10/16/2020
8.1.0 988 9/23/2020
8.0.0 1,682 7/1/2020
8.0.0-dev.44 213 6/25/2020
8.0.0-dev.43 194 6/23/2020
8.0.0-dev.42 227 6/22/2020
8.0.0-dev.41 224 6/18/2020
8.0.0-dev.40 187 6/18/2020
8.0.0-dev.39 207 6/15/2020
8.0.0-dev.38 318 6/14/2020
8.0.0-dev.37 184 6/13/2020
8.0.0-dev.36 231 6/13/2020
8.0.0-dev.35 176 6/12/2020
8.0.0-dev.34 207 6/12/2020
8.0.0-dev.33 264 6/10/2020
8.0.0-dev.32 194 6/1/2020
8.0.0-dev.31 214 6/1/2020
8.0.0-dev.30 278 5/30/2020
8.0.0-dev.28 215 5/28/2020
8.0.0-dev.27 206 5/15/2020
8.0.0-dev.26 188 5/14/2020
8.0.0-dev.25 199 5/14/2020
8.0.0-dev.24 186 5/13/2020
8.0.0-dev.23 190 5/13/2020
8.0.0-dev.22 199 5/13/2020
8.0.0-dev.21 204 5/12/2020
8.0.0-dev.20 198 5/12/2020
8.0.0-dev.19 202 5/7/2020
8.0.0-dev.18 197 5/7/2020
8.0.0-dev.17 186 5/6/2020
8.0.0-dev.16 201 5/6/2020
8.0.0-dev.15 198 5/5/2020
8.0.0-dev.14 187 5/5/2020
8.0.0-dev.13 215 5/4/2020
7.6.0-dev.13 219 5/1/2020
7.6.0-dev.12 218 4/30/2020
7.6.0-dev.11 200 4/28/2020
7.6.0-dev.10 191 4/27/2020
7.6.0-dev.9 189 4/24/2020
7.6.0-dev.8 186 4/22/2020
7.6.0-dev.7 187 4/15/2020
7.6.0-dev.6 185 4/15/2020
7.6.0-dev.5 182 4/15/2020
7.6.0-dev.4 315 4/11/2020
7.6.0-dev.3 190 4/10/2020
7.6.0-dev.2 198 4/10/2020
7.6.0-dev.1 280 4/8/2020
7.5.2 920 3/20/2020
7.5.1 721 3/12/2020
7.5.0 980 3/10/2020
7.5.0-dev.18 228 3/5/2020
7.5.0-dev.17 229 3/5/2020
7.5.0-dev.16 249 3/4/2020
7.5.0-dev.15.1 273 3/4/2020
7.5.0-dev.15 198 3/3/2020
7.5.0-dev.14 209 3/3/2020
7.5.0-dev.13 191 2/29/2020
7.5.0-dev.12 319 2/29/2020
7.5.0-dev.10 190 2/25/2020
7.5.0-dev.9 246 2/20/2020
7.5.0-dev.8 268 2/18/2020
7.5.0-dev.7 198 2/18/2020
7.5.0-dev.6 218 2/14/2020
7.5.0-dev.5 227 2/12/2020
7.5.0-dev.4 214 2/11/2020
7.5.0-dev.3 181 2/11/2020
7.5.0-dev.2 329 2/8/2020
7.5.0-dev.1 226 2/7/2020
7.4.2 938 2/5/2020
7.4.1 965 2/3/2020
7.4.0 991 1/31/2020
7.4.0-dev.4 265 1/31/2020
7.4.0-dev.3 250 1/29/2020
7.4.0-dev.2 204 1/28/2020
7.4.0-dev.1 200 1/23/2020
7.3.1 904 1/21/2020
7.3.1-preview.7 206 1/21/2020
7.3.1-preview.1 241 1/20/2020
7.3.0 907 1/19/2020
7.2.6 835 1/18/2020
7.2.5 892 12/19/2019
7.2.4 745 12/19/2019
7.2.3 755 12/16/2019
7.2.2 763 12/9/2019
7.2.1 867 12/4/2019
7.2.0 829 11/26/2019
7.2.0-preview.10 207 11/20/2019
7.2.0-preview.9 206 11/19/2019
7.2.0-preview.8 207 11/18/2019
7.2.0-preview.6 216 11/14/2019
7.2.0-preview.5 209 11/14/2019
7.2.0-preview.4 211 11/14/2019
7.2.0-preview.2 210 11/11/2019
7.2.0-preview.1 218 11/9/2019
7.1.2 391 11/7/2019
7.1.1 374 11/6/2019
7.1.0 989 11/6/2019
7.1.0-preview.8 221 11/5/2019
7.1.0-preview.7 220 11/4/2019
7.1.0-preview.6 215 11/1/2019
7.1.0-preview.5 238 10/31/2019
7.1.0-preview.4 233 10/30/2019
7.1.0-preview.3 213 10/26/2019
7.1.0-preview.2 220 10/25/2019
7.1.0-preview.1 215 10/24/2019
7.0.0 642 10/16/2019
7.0.0-rc.41 228 10/15/2019
7.0.0-rc.40 234 10/15/2019
7.0.0-rc.39 220 10/12/2019
7.0.0-rc.38 216 10/11/2019
7.0.0-rc.37 254 10/10/2019
7.0.0-rc.36 219 10/9/2019
7.0.0-rc.35 216 10/8/2019
7.0.0-rc.34 218 10/8/2019
7.0.0-rc.33 209 10/7/2019
7.0.0-rc.32 216 10/5/2019
7.0.0-rc.31 218 10/3/2019
7.0.0-rc.30 228 10/1/2019
7.0.0-rc.28 226 10/1/2019
7.0.0-rc.27 209 9/30/2019
7.0.0-rc.26 220 9/30/2019
7.0.0-rc.25 223 9/27/2019
7.0.0-rc.24 213 9/27/2019
7.0.0-rc.23 213 9/26/2019
7.0.0-rc.22 212 9/25/2019
7.0.0-rc.21 215 9/24/2019
7.0.0-rc.20 221 9/23/2019
7.0.0-rc.19 213 9/20/2019
7.0.0-rc.18.1 218 9/20/2019
7.0.0-rc.18 213 9/20/2019
6.5.0-rc.17 231 9/19/2019
6.5.0-rc.16 238 9/18/2019
6.5.0-rc.15 238 9/18/2019
6.5.0-rc.14.1 220 9/18/2019
6.5.0-rc.14 235 9/17/2019
6.5.0-rc.13 229 9/16/2019
6.5.0-rc.12.2 231 9/13/2019
6.5.0-rc.12.1 222 9/12/2019
6.5.0-rc.12 230 9/12/2019
6.5.0-rc.11 230 9/11/2019
6.5.0-rc.10 224 9/10/2019
6.5.0-rc.9 230 9/9/2019
6.5.0-rc.8 223 9/6/2019
6.5.0-rc.7 224 9/6/2019
6.5.0-rc.6 225 9/6/2019
6.5.0-rc.5 221 9/2/2019
6.5.0-rc.4 239 9/2/2019
6.5.0-rc.3 227 8/30/2019
6.5.0-rc.2 240 8/29/2019
6.5.0-rc.1 245 8/28/2019
6.5.0-beta.5 238 8/28/2019
6.5.0-beta.4 240 8/27/2019
6.0.0 734 8/6/2019
6.0.0-rc.7 228 7/19/2019
6.0.0-rc.6 236 6/28/2019
6.0.0-rc.5 230 6/28/2019
6.0.0-rc.4 234 6/25/2019
6.0.0-rc.3 233 6/20/2019
6.0.0-rc.2 237 5/29/2019
6.0.0-rc.1 241 5/28/2019
6.0.0-beta.3 249 4/17/2019
5.3.0-beta.2 233 3/21/2019
5.3.0-beta.1 227 3/20/2019
5.2.0 774 3/19/2019
5.1.0 1,039 1/25/2019
5.0.0 1,003 12/21/2018
5.0.0-rc11 836 12/14/2018
5.0.0-rc10 696 11/16/2018
5.0.0-rc09 723 11/1/2018
5.0.0-rc08 721 10/31/2018
5.0.0-rc07 673 10/31/2018
5.0.0-rc06 739 10/30/2018
5.0.0-rc05 720 10/29/2018
5.0.0-rc04 699 10/29/2018
5.0.0-rc03 727 10/26/2018
5.0.0-rc02 727 10/25/2018
5.0.0-rc01 735 10/12/2018
5.0.0-beta03 739 9/21/2018
5.0.0-beta02 753 9/10/2018
5.0.0-beta01 717 9/7/2018
4.5.1 696 8/7/2018
4.5.0 1,269 8/7/2018
4.5.0-rc01 772 6/7/2018
4.5.0-beta09 753 6/7/2018
4.5.0-beta08 962 5/16/2018
4.5.0-beta07 747 5/9/2018
4.5.0-beta06 760 4/25/2018
4.5.0-beta05 919 4/12/2018
4.5.0-beta03 859 4/12/2018
4.2.0-beta02 853 3/27/2018
4.2.0-beta01 849 2/14/2018
4.1.1 816 2/1/2018
4.1.0 1,110 1/15/2018
4.1.0-rc10 910 12/19/2017
4.1.0-rc09 913 12/19/2017
4.1.0-rc08 920 12/12/2017
4.1.0-rc07 758 12/5/2017
4.1.0-rc06 819 12/5/2017
4.1.0-rc05 772 12/5/2017
4.1.0-rc03 776 12/4/2017
4.1.0-rc02 818 12/4/2017
4.1.0-rc01 778 12/4/2017
4.1.0-beta09 823 12/3/2017
4.1.0-beta08 819 11/25/2017
4.1.0-beta07 819 11/23/2017
4.1.0-beta06 786 11/22/2017
4.1.0-beta05 788 11/21/2017
4.1.0-beta04 627 11/21/2017
4.1.0-beta03 636 11/17/2017
4.1.0-beta02 605 11/17/2017
4.1.0-beta01 604 11/16/2017
4.0.1-beta01 618 11/6/2017
4.0.0 1,684 10/23/2017
4.0.0-rc05 764 10/17/2017
4.0.0-rc04 770 10/17/2017
4.0.0-rc03 799 10/12/2017
4.0.0-rc02 810 10/10/2017
4.0.0-rc01 780 10/6/2017
4.0.0-beta9 777 10/5/2017
4.0.0-beta8 789 10/5/2017
4.0.0-beta7 817 10/3/2017
4.0.0-beta6 787 9/30/2017
4.0.0-beta5 788 9/28/2017
4.0.0-beta4 788 9/27/2017
4.0.0-beta3 776 9/26/2017
4.0.0-beta2 795 9/25/2017
4.0.0-beta1 777 9/22/2017
3.11.0 971 8/18/2017
3.10.1 766 8/18/2017
3.10.0 1,161 8/1/2017
3.9.1 772 6/23/2017
3.9.0 1,172 6/13/2017
3.8.1 894 5/26/2017
3.8.0 879 5/26/2017
3.7.0 882 5/23/2017
3.6.0 888 5/18/2017
3.5.0 868 5/15/2017
3.4.0 864 5/4/2017
3.3.6 760 4/13/2017
3.3.5 773 4/12/2017
3.3.1 774 4/12/2017
3.3.0 1,177 4/12/2017
3.3.0-preview1 739 4/6/2017
3.2.0 984 3/27/2017
3.1.0 949 3/22/2017
3.1.0-preview4 887 3/9/2017
3.1.0-preview3 830 12/9/2016
3.1.0-preview2 785 12/9/2016
3.1.0-preview1-rc2 722 10/31/2016
3.1.0-preview1 758 10/28/2016
3.0.9 917 10/19/2016
3.0.8 856 8/19/2016
3.0.7 971 7/12/2016
3.0.7-pre1 783 5/18/2016
3.0.6 837 5/13/2016
3.0.5 1,205 4/27/2016
3.0.4 828 4/14/2016
3.0.0-rc6 731 3/29/2016
3.0.0-rc5 742 3/24/2016
3.0.0-rc4 934 3/21/2016
3.0.0-rc3 833 12/22/2015
3.0.0-rc1 849 12/21/2015

Please check https://github.com/kephas-software/kephas/releases for the change log.
           Also check the documentation and the samples from https://github.com/kephas-software/kephas/wiki and https://github.com/kephas-software/kephas/tree/master/Samples.