14.6 Serve it
The hub serves the derived machine beside checkout's: ServeFeatures names the folder, and the
assemblies after it are still searched for machine classes.
Shopfront.Hub/Program.cs:
using Shopfront;
using Shopfront.Auth;
using Shopfront.Data;
using Shopfront.Extensions;
using Shopfront.Staff;
using Shopfront.Suppliers;
using Shopfront.Trains.LowStockCheck;
using Shopfront.Trains.Restock;
using Shopfront.Trains.StockReport;
using Trax.Api.Auth.Jwt;
using Trax.Api.Dashboard.Extensions;
using Trax.Api.GraphQL.Extensions;
using Trax.Api.GraphQL.PersistedOperations.Extensions;
using Trax.Effect.Data.Extensions;
using Trax.Effect.Data.Postgres.Extensions;
using Trax.Effect.Data.Services.DomainContext;
using Trax.Effect.Enums;
using Trax.Effect.Extensions;
using Trax.Effect.JunctionProvider.Logging.Extensions;
using Trax.Effect.JunctionProvider.Progress.Extensions;
using Trax.Effect.Models.Manifest;
using Trax.Effect.Provider.Parameter.Extensions;
using Trax.StateMachine.Persistence;
using Trax.Mediator.Extensions;
using Trax.Scheduler.Extensions;
using Trax.Scheduler.Services.JobSubmitter;
using Trax.Scheduler.Services.Scheduling;
var builder = WebApplication.CreateBuilder(args);
var connectionString =
builder.Configuration.GetConnectionString("Shopfront")
?? throw new InvalidOperationException("ConnectionStrings:Shopfront is not set.");
var development = builder.Environment.IsDevelopment();
builder.Services.AddShopfront(connectionString);
if (development)
builder.Services.AddTraxJwtAuth(jwt =>
jwt.UseSymmetricKey(DevJwt.Issuer, DevJwt.Audience, DevJwt.Key)
);
else
builder.Services.AddTraxJwtAuth(
builder.Configuration["Auth:Authority"]
?? throw new InvalidOperationException("Auth:Authority is not set."),
builder.Configuration["Auth:Audience"]
?? throw new InvalidOperationException("Auth:Audience is not set.")
);
builder.Services.AddAuthorization();
builder.Services.AddScoped<ISnapshotPrincipal, TraxCallerSnapshotPrincipal>();
builder.Services.AddTrax(trax =>
trax.AddEffects(effects =>
effects
.UsePostgres(connectionString)
.SaveTrainParameters()
.AddJunctionLogger(serializeJunctionData: true)
.AddJunctionProgress()
.AddDecisionRecording()
.AddJunctionEvents()
.AddLifecycleHook<StaffFailureHook>()
)
// Checkout and the parcel are classes in the library. Returns are derived from
// features/ by trax machine from-gherkin, which writes machines/from-features; the
// build copies it to machines/ beside the hub.
.AddStateMachines(
machines => machines.ServeFeatures("machines", typeof(ManifestNames).Assembly),
typeof(ManifestNames).Assembly
)
.AddMediator(typeof(ManifestNames).Assembly)
.AddScheduler(scheduler =>
{
// The hub hands every job to the worker through Postgres and runs none itself.
scheduler.OverrideSubmitter(services =>
services.AddScoped<IJobSubmitter, PostgresJobSubmitter>()
);
// In Development, retries come seconds apart, and a run whose worker died is given up
// on after a minute rather than an hour, to be watched.
if (development)
scheduler
.DefaultRetryDelay(TimeSpan.FromSeconds(5))
.MaxRetryDelay(TimeSpan.FromSeconds(30))
.DefaultJobTimeout(TimeSpan.FromSeconds(30))
.StaleInProgressTimeout(TimeSpan.FromMinutes(1));
return scheduler
.Schedule<IStockReportTrain>(
ManifestNames.StockReport,
new StockReportInput(),
Cron.Daily(hour: 2),
options =>
options
// The shop's holidays: no count, and none the morning after.
.Exclude(
Exclude.Dates(new DateOnly(2026, 12, 25), new DateOnly(2027, 1, 1))
)
.OnMisfire(MisfirePolicy.DoNothing)
.Variance(TimeSpan.FromMinutes(10))
)
.ThenInclude<ILowStockCheckTrain>(
ManifestNames.LowStockCheck,
new LowStockCheckInput { Threshold = 3 }
)
.Schedule<IRestockTrain>(
ManifestNames.Restock,
new RestockInput { Threshold = 3 },
development ? Every.Minutes(1) : Every.Hours(1),
options => options.MaxRetries(2)
);
})
);
builder.Services.AddTraxGraphQL(graphql =>
graphql
.AddDbContext<ShopfrontDbContext>()
.ExposeOperationQueries()
.ExposeOperationMutations()
.GateOperations(roles: Roles.Staff)
// Shadow mode: everything runs, and what would be refused is logged.
.UsePersistedOperations(persisted =>
persisted.SingleNode().RequirePersisted(false).LogNonPersistedRequests(true)
)
);
var app = builder.Build();
await app.Services.EnsureSchemaCreatedAsync<ShopfrontDbContext>();
app.UseAuthentication();
app.UseAuthorization();
app.UseTraxGraphQL();
app.UseTraxApiDashboard(dashboard => dashboard.AllowAnonymousShell());
if (development)
{
app.MapGet(
"/dev/token/{user}",
(string user, bool staff = false) =>
DevJwt.Mint(user, staff ? Roles.Staff : Roles.Customer)
)
.AllowAnonymous();
// Takes this process's fake supplier down, or brings it back.
app.MapPost(
"/dev/supplier/{state}",
(string state, FakeSupplier supplier) =>
{
supplier.IsDown = state == "down";
return Results.NoContent();
}
)
.AllowAnonymous();
}
await app.RunAsync();The build copies the derived files beside the hub, as machines/.
Shopfront.Hub/Shopfront.Hub.csproj:
<Project Sdk="Microsoft.NET.Sdk.Web">
<PropertyGroup>
<TargetFramework>net10.0</TargetFramework>
<Nullable>enable</Nullable>
<ImplicitUsings>enable</ImplicitUsings>
<RootNamespace>Shopfront</RootNamespace>
</PropertyGroup>
<ItemGroup>
<!-- The host tests start the hub. -->
<InternalsVisibleTo Include="Shopfront.Tests" />
</ItemGroup>
<ItemGroup>
<!-- The machines trax machine from-gherkin derives from ../features, as committed. The hub
serves them from machines/ beside it, and refuses to start if they disagree. -->
<None
Include="..\machines\from-features\*"
LinkBase="machines"
CopyToOutputDirectory="PreserveNewest"
/>
</ItemGroup>
<ItemGroup>
<ProjectReference Include="..\Shopfront.Core\Shopfront.Core.csproj" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="Trax.Api.Auth.Jwt" />
<PackageReference Include="Trax.Api.Dashboard" />
<PackageReference Include="Trax.Api.GraphQL" />
<PackageReference Include="Trax.Api.GraphQL.PersistedOperations" />
<PackageReference Include="Trax.Effect.JunctionProvider.Logging" />
<PackageReference Include="Trax.Effect.JunctionProvider.Progress" />
<PackageReference Include="Trax.Effect.Provider.Parameter" />
<PackageReference Include="Trax.Scheduler" />
</ItemGroup>
</Project>ServeFeatures("machines", ...)serves each IR in the folder with the access, the train and the view itshost.jsongives. The assembly after the path is where the train is found.- The hub checks the pair when it starts.
host.jsonwas derived from one IR and records its hash. An IR edited by hand, or a host file left behind by a changed feature, refuses the start and names the file. So does a train the lexicon names that the library does not hold, or a type there that is not a train. - It is served as checkout is.
machines { orderReturn { start describe send get } }, with the rulehost.jsongives on each, andviews { returns }as a query of its own.
SDK Reference
Write machines as features | Feature files | Feature machines | Feature bindings | AddStateMachines | Views root | trax CLI
Next: 14.7 Return an order