FluxFlow.Components.Expectations 2.0.0

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package FluxFlow.Components.Expectations --version 2.0.0
                    


                    

                
NuGet\Install-Package FluxFlow.Components.Expectations -Version 2.0.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="FluxFlow.Components.Expectations" Version="2.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="FluxFlow.Components.Expectations" Version="2.0.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="FluxFlow.Components.Expectations" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add FluxFlow.Components.Expectations --version 2.0.0
                    


                    

                
#r "nuget: FluxFlow.Components.Expectations, 2.0.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. 
#:package FluxFlow.Components.Expectations@2.0.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=FluxFlow.Components.Expectations&version=2.0.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=FluxFlow.Components.Expectations&version=2.0.0
                    


                            Install as a Cake Tool

FluxFlow.Components.Expectations

Reusable event expectation components for FluxFlow.

Nodes

Node type Shape Purpose
event.expect Input → Result, Errors Waits for a matching runtime event and emits one expectation result.
event.guard Input → Result, Errors Guards against a matching runtime event and emits one guard result.

Both nodes consume FlowEvent values from FluxFlow.Engine and emit EventExpectationResult values.

Example

{
  "type": "event.expect",
  "name": "order-completed",
  "timeoutMilliseconds": 5000,
  "maxObservedEvents": 10,
  "maxPreviewChars": 256,
  "filter": {
    "type": "operation.completed",
    "status": "ok",
    "subjectPrefix": "orders/"
  }
}

event.guard uses the same options, but a matching event means the guard is not satisfied.

Result

EventExpectationResult includes:

  • evaluated timestamp
  • expectation name
  • expectation kind
  • satisfied flag
  • matched flag
  • timeout flag
  • matched event summary when one exists
  • recent observed event summaries
  • filter copy
  • reason text

Filters

Expectations use the same neutral EventFilter contract as the Projections package. Filters support:

  • event type or type prefix
  • subject prefix
  • channel prefix
  • excluded subject prefix
  • excluded channel prefix
  • status
  • source
  • source node id
  • component id through an event attribute named componentId
  • attribute key/value pairs
  • event timestamp range

Filters use ordinal string comparison.

Timing

Use ExpectationsComponentOptions.UseClock(...) for deterministic timeout and result timestamps in tests or hosts.

registry.RegisterExpectationsComponents(options =>
    options.UseClock(timeProvider));

Boundaries

This package has no UI dependency, no concrete transport dependency, and no host-specific scenario runner dependency. Hosts decide how to feed events into the nodes and how to display, store, or assert the emitted results.

Product Compatible and additional computed target framework versions.
.NET 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.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on FluxFlow.Components.Expectations:

Package Downloads
FluxFlow.Components.Expectations.Composition

Canonical projection-event expectation registration and Designer metadata over exact host-owned clock addresses.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
7.0.0-rc.1 86 9/5/2026
6.0.0 182 8/3/2026
3.0.2 121 7/3/2026
3.0.1 177 7/2/2026
3.0.0 123 6/19/2026
2.0.0 126 6/18/2026
1.2.0 118 6/12/2026
1.1.0 128 6/12/2026
1.0.0 128 6/4/2026
0.1.0-alpha.1 73 6/3/2026

2.0 preview: the node's static Create(RuntimeNodeFactoryContext …) factory moves into a dedicated internal *NodeFactory class, removing the public static Create from the node type (breaking). Node registration, options, ports, JSON shape, and runtime behavior are unchanged. Replaces the bespoke IExpectationClock abstraction with System.TimeProvider (UseClock now takes a TimeProvider; the old clock interface/implementation are removed).