Trax.Client
1.69.0
Prefix Reserved
See the version list below for details.
dotnet add package Trax.Client --version 1.69.0
NuGet\Install-Package Trax.Client -Version 1.69.0
<PackageReference Include="Trax.Client" Version="1.69.0" />
<PackageVersion Include="Trax.Client" Version="1.69.0" />
<PackageReference Include="Trax.Client" />
paket add Trax.Client --version 1.69.0
#r "nuget: Trax.Client, 1.69.0"
#:package Trax.Client@1.69.0
#addin nuget:?package=Trax.Client&version=1.69.0
#tool nuget:?package=Trax.Client&version=1.69.0
Trax.StateMachine
Part of Trax .NET: one description of your app, for the whole team. Every part of the app has a place, so you only have to write what it does. Docs · Getting started · Repository
Trax.StateMachine is the portable state-machine engine: a multi-step flow's state as language-neutral JSON, with
each event's guard, reducer and caller rule declared as data. Trax.StateMachine.Persistence stores each
instance per user, runs a machine's one irreversible effect once per intent, and lets a state invoke a train.
@traxsharp/state-machine on npm runs the same machine in the browser.
Install
dotnet add package Trax.StateMachine.Persistence
dotnet add package Trax.StateMachine.Testing # in a test project
dotnet add package Trax.StateMachine.Client # in a .NET frontend that drives a served machine
dotnet add package Trax.StateMachine.Gherkin # to derive machines from features and a glossary
dotnet add package Trax.StateMachine.Gherkin.Reqnroll # in a Reqnroll test project that runs them on a host
Reqnroll itself, which Trax.StateMachine.Gherkin.Reqnroll brings in, sends usage telemetry when it generates a
project's feature code and when a test run starts. Set REQNROLL_TELEMETRY_ENABLED=0 where those builds and tests run
to turn it off. The Trax bindings send nothing.
Example
From Author and serve a machine:
[TraxMachine]
public sealed class CheckoutMachine : Machine<CheckoutState, CheckoutTrigger>
{
protected override void Configure(IMachineBuilder<CheckoutState, CheckoutTrigger> m)
{
m.Id("checkout").Version(1) /* start, rules on Get, Watch and Discard */;
m.In(CheckoutState.Review)
.Context<CartContext>()
.On(CheckoutTrigger.Pay)
.AnyAuthenticated()
.WithInput<PayInput>()
.RunsOnce<ICharge>("checkout:charge")
.To(CheckoutState.Paid);
m.In(CheckoutState.Paid).Context<PaidContext>().Committed();
}
}
builder.Services.AddTrax(trax =>
trax.AddEffects(effects => effects.UsePostgres(connectionString))
.AddStateMachines(typeof(CheckoutMachine).Assembly)
.AddMediator(typeof(CheckoutMachine).Assembly));
The server runs ICharge once per send and fires Pay with its receipt. A client never fires Pay itself.
Where this fits
Trax is split into layers, one folder of this repository each. Take the ones you need; the trains you wrote do not change. You are here: Trax.StateMachine.
| Folder | What it adds |
|---|---|
| Trax.Core | Trains, junctions and the chain, with no database and no DI container |
| Trax.Effect | A recorded run for every execution (Postgres, SQLite or in memory), DI, effect providers |
| Trax.StateMachine | State machines a page drives and the server applies, in C# and TypeScript, held to one conformance kit |
| Trax.Mediator | The train bus: run a train by handing over its input, with every chain checked at startup |
| Trax.Scheduler | Cron and interval schedules, retries, dead letters, and workers on other machines or in Lambda |
| Trax.Api | GraphQL generated from your trains, with authentication, audit and typed clients, and the operations console your host serves |
| Trax.Cli | The trax tool: scaffold a hub and trains from an OpenAPI or GraphQL schema, and state-machine codegen |
| Trax.Samples | Complete sample apps, and the trax-api, trax-scheduler and trax-hub templates |
Docs live in Trax.Docs and are published at traxsharp.net/docs.
Contributing
Read AGENTS.md before changing code. Report vulnerabilities privately as described in SECURITY.md.
License
MIT. There is no commercial edition, and there will not be one.
Trax .NET is an independent open-source project and is not affiliated with the Utah Transit Authority, Trax Retail, or any other organization using the Trax name.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | 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. |
-
net10.0
- No dependencies.
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Trax.Client:
| Package | Downloads |
|---|---|
|
Trax.StateMachine.Client
Drive a Trax state machine a host serves from .NET: Blazor, MAUI, Avalonia, WPF or another service. Sends each operation by the persisted id the host's client manifest lists, follows the instance over a graphql-transport-ws socket, predicts each event with the Trax.StateMachine engine and replaces the prediction with what the server stored. Every operation answers a refusal or a transport failure as a value. |
GitHub repositories
This package is not used by any popular GitHub repositories.