ActionOptions

@rotorsoft/act-root

---

@rotorsoft/act-root / act/src / ActionOptions

Type Alias: ActionOptions

ActionOptions = object

Defined in: libs/act/src/types/action.ts:530

Per-action retry policy, declared on state.on(entry, options). The orchestrator owns the loop on the command path: on ConcurrencyError the cache is invalidated, an optional backoff delay is applied, and the action re-runs from load. Any other error rethrows immediately and does not consume the budget.

No blockOnError field — commands surface errors to callers; they do not block streams.

Properties

backoff?

readonly optional backoff?: BackoffOptions

Defined in: libs/act/src/types/action.ts:532

Optional retry pacing. When omitted, retries run immediately — fine at low contention. Set to { strategy: "exponential", baseMs, jitter: true } on hot streams where many writers contend for the same version.

---

maxRetries?

readonly optional maxRetries?: number

Defined in: libs/act/src/types/action.ts:531

Additional attempts after the initial call. Default 0 (single attempt, current behavior). Total invocations equal 1 + maxRetries.