C#-friendly Actor API

Low-level wiring over an IActor: register the saga-starter, aggregates and actors, and send commands. Most members are plain static helpers (you call ActorWiring.Foo(actor, …)); a couple are genuine extension methods. For app composition, prefer the host-builder API (AddFcqrs/AddAggregate/AddSaga).

C#-friendly abstract base for an event-sourced aggregate. A concrete aggregate supplies only InitialState, EntityName, HandleCommand (the decision) and ApplyEvent (the fold); the base provides the wiring (Init). Designed to be subclassed from C#.

C# delegate for an aggregate's entity-ref factory: an id -> its sharded actor ref. sp.AggregateFactory<T>() returns one; sagas use it to target an aggregate.

The two C#-facing pieces of a wired aggregate: a Factory for entity refs (used by sagas to target the aggregate) and a Handler to send a command and await its event (used by the delivery layer). Returned by InitAggregate.

Diagnostics helper: a short, readable case name for logging. Unwraps a Command<_>/Event<_> envelope to its payload (via IEnvelope), then a C# `union` to its active case (its generated `.Value`), and falls back to the type name — so F# DUs and plain payloads work too. Reflection-based; meant for logs, not hot paths.

C#-friendly factory methods for EventAction

C#-friendly factory methods for constructing an F# Result (Ok/Error) from C#.

C# delegate for command handlers - returns Task>

Extension methods for ISubscribe

Fluent registrar for stable journal type names (see JournalTypes).

C#-friendly factory for PrefixConversion

C#-friendly Query API

C#-friendly abstract base for a saga. A concrete saga supplies InitialData, SagaName, Originator (the aggregate it starts from), HandleEvent and ApplySideEffects; the base provides the wiring (Init/Factory) and the small transition DSL. Designed to be subclassed from C#.

Low-level C# saga API (mirrors ActorApi/QueryApi). For most sagas, prefer the Saga<_,_,_> base class, which wraps this.

C#-friendly saga command targeting

C#-friendly class for defining saga starters (uses class for C# object initializer syntax)

C#-friendly factory methods for saga EventAction

C#-friendly result type for saga side effects (uses class for C# object initializer syntax)

C#-friendly helpers for SagaState

C#-friendly factory methods for SagaTransition

C#-friendly builders for the Command/Event envelopes that the pure handleCommand/applyEvent functions expect. Intended for unit tests: the envelope's plumbing fields (a fresh MessageId/CID, a UTC timestamp, no sender, empty metadata) are filled in for you, so a test supplies only the payload — and, for events, the aggregate version. The framework builds these envelopes itself at runtime; tests are the one place you build them by hand.

Factory methods for creating FCQRS's strongly-typed value/identifier types (CID, AggregateId, MessageId, ShortString, LongString, Version) from C#.