Repository navigation
v1.64.0
·
64 commits
to main
since this release
Immutable
release. Only release title and notes can be modified.
1.64.0 (2026-10-15)
π¨πͺπ§π¦β¬π₯ Generated clients, and operations is admin only (#57)
Generated clients
- β¬
trax client --target react --manifest <file> --out <dir>writes a frontend's typed client:
each machine's twin and typed hooks, a typed function per train, the GraphQL types they use and
run-progress hooks.--checkexits 1 when the committed client is out of date. It deletes only files it wrote,
and refuses to write through a link under--out. - πͺπ¦ Hosts call
await app.RunTraxAsync(args);--trax-export-client <path>writes the client
manifest without serving or opening a database. - π¦ Every
[TraxMutation]/[TraxQuery]train gets a persisted document the host registers. A
client of an older shape getsCLIENT_OUTDATED, not a validation error.
Following a run
- π¨π¦
[TraxRunProgress]lets the caller who started a run read and follow it with
runProgress(runId); nobody else can.ScheduleOptions.StartedBycarries the starter to every run
of a manifest, and a retried run answersretriedAs. A queued run the host cannot read ends its stream with a
problem after repeated failures; subscribe again. - β¬π¦
useRunProgressfollows nothing after anotherusersigns in until it is given a run id again, and
followRunProgressends withCONNECTION_CHANGEDwhenconfigureTraxcloses its socket. - πͺπ¦ A machine waiting on a run it invoked answers its owner
invokedRun { runId }.
Breaking for clients
- πͺπ¦
machineChangedis replaced by<machine>Changed(id), typed per machine. - πͺπ¦ Refusal codes are one enum, spelled
GUARD_FAILEDeverywhere,extensions.codeincluded. - πͺπ¦ Context and input enums of a machine are spelled as stored (
HighPriority). - πͺ
@traxsharp/state-machinedropsuseMachine,createSnapshotClientandcreateHttpExecutor;
createMachineExecutorrequires each machine's documents. - πͺ The IR's effect edge no longer carries the server's type name.
- πͺ Generated code is client format 2:
configureTrax({ url, headers, user })re-renders mounted hooks onto the
new connection, anduseRemembered<Machine>()keeps each user's instance under its own key for thatuser. The
runtime still serves format 1. - πͺ An effect-bound trigger takes no input in the generated
send. Installgraphql-wsbeside the package. - πͺ A trigger bound with
RunsOncemay not also be used on another edge; the build says so. - πͺ A request on a generated server made before the last
configureTraxstops its controller with
CONNECTION_CHANGEDinstead of failing as a retryable transport error. - π¦πͺ A machine may not hold one of Trax's own enums; give it an enum of its own.
- πͺ
@traxsharp/state-machinehas no runtime dependencies: valibot, which nothing used, is gone.
Operations is admin only
- π¦ Persisted-operation management moved to a root
persistedOperations { ... }behind its own gate,
GateManagement(policy, roles), in GraphQL and both dashboards. It is not served until a host declares that gate,
andUsePersistedOperationsno longer exposes theoperationsnamespace.ExposeOperationsNamespaceis removed. - π¦π₯ The management gate is checked on every dashboard read too, its policies run in the caller's scope, and a
store registration that declares a different gate fromUsePersistedOperationsis refused at startup. - π¦
operationsholds only what the operations dashboard does:machineDocuments,declaredChain, and the
execution(id),manifest(id)andworkQueue(id)reads are removed in favour of the client manifest export,
runGraphand the detail reads. Monitors read/trax/health.
See the machine wire changes migration guide for the upgrade.